Skip to main content
CheckTown
Dev Tools

Riparazione JSON: ripara JSON rotto da API e LLM

Pubblicato 5 min di lettura
In questo articolo

Errori JSON comuni

JSON ha regole di sintassi rigorose che fanno inciampare regolarmente gli sviluppatori. Una singola virgola fuori posto, una chiave senza virgolette o una virgola finale renderà l'intero documento invalido. I parser JSON standard rifiutano questi errori completamente, dando solo un messaggio di errore.

Gli errori JSON più frequenti includono virgole finali dopo l'ultimo elemento, virgolette singole invece di doppie, chiavi senza virgolette, commenti incorporati (// o /* */), parentesi mancanti e caratteri speciali non escapati. Gli strumenti di riparazione JSON correggono tutto automaticamente.

Come funziona la riparazione JSON

Uno strumento di riparazione JSON usa un approccio basato su parser anziché semplice ricerca-sostituzione con regex. Legge l'input carattere per carattere, mantenendo una macchina a stati che traccia la posizione corrente nella struttura JSON.

  • Correzione basata su parser — il motore di riparazione mantiene uno stato di analisi (dentro oggetto, array, stringa) e usa questo contesto per determinare la correzione appropriata
  • Bilanciamento parentesi e graffe — traccia aperture e chiusure e aggiunge automaticamente i chiusori mancanti alla fine o dove la struttura li implica
  • Normalizzazione virgolette — converte virgolette singole in doppie, aggiunge virgolette mancanti attorno alle chiavi e esegue il corretto escape dei caratteri speciali

Prova gratuitamente — nessuna registrazione richiesta

Ripara JSON →

Output LLM e JSON troncato

I grandi modelli linguistici producono frequentemente JSON malformato. Possono troncare l'output a metà oggetto, dimenticare parentesi di chiusura o aggiungere commenti. La riparazione JSON gestisce tutti questi problemi specifici degli LLM.

  • Output troncato — quando un LLM smette di generare a metà oggetto, lo strumento chiude tutte le strutture aperte nell'ordine corretto per produrre JSON valido
  • Blocchi di codice Markdown — gli LLM spesso avvolgono il JSON in blocchi ```json...```. Lo strumento rimuove questi delimitatori prima dell'elaborazione
  • Contenuto misto — gli LLM a volte aggiungono testo o commenti attorno al JSON. Lo strumento estrae solo la porzione JSON e corregge i problemi di sintassi

Domande frequenti

La riparazione JSON può causare cambiamenti distruttivi?

La riparazione JSON è conservativa per design — corregge solo errori di sintassi, senza mai modificare i valori dei dati. I dati effettivi rimangono intatti. L'output riparato è semanticamente identico a ciò che l'autore intendeva.

Come gestisce la riparazione i problemi di codifica?

JSON richiede codifica UTF-8. Lo strumento gestisce problemi comuni come BOM all'inizio del file, sequenze di escape non valide e caratteri di controllo non escapati nelle stringhe.

Il JSON profondamente annidato può essere riparato?

Sì. L'approccio basato su parser gestisce annidamento arbitrariamente profondo perché mantiene uno stack di strutture aperte. Che l'input abbia 3 o 30 livelli, il motore traccia ogni livello e chiude correttamente le strutture lasciate aperte.

Strumenti correlati