json.decoder.JSONDecodeError: Invalid control character at: line 1 column 79 (char 78)
În interiorul unui șir din JSON există un caracter de control neescapat, de obicei un Enter real (newline) sau un Tab. JSON-ul strict cere \n în loc de rând nou. Folosește json.loads(text, strict=False) sau ieșirea structurată, care produce mereu JSON corect escapat.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În JSON, un șir între ghilimele nu poate conține direct caractere de control (cod sub 32): rând nou, tab, retur de car. Ele trebuie scrise escapat: \n, \t. Parserul Python e strict implicit și se oprește la primul astfel de caracter, iar poziția din mesaj arată exact unde e.
Cu modelele, cazul clasic e un câmp lung (rezumat, descriere, adresă pe mai multe rânduri) în care modelul a pus un rând nou real, nu \n. JSON-ul arată corect la afișare, dar nu se parsează.
Afișează repr(text[70:90]) în jurul poziției: vei vedea \n în reprezentare, adică un rând nou real în text.
De ce apare: cauzele frecvente
1Rând nou real într-un câmp text
text = '{"rezumat": "Produs deteriorat.\nCere înlocuirea."}' # rând nou real
json.loads(text)date = json.loads(text, strict=False)strict=False acceptă caractere de control în șiruri; restul regulilor JSON rămân.
2JSON scris de model în text liber
system = "Răspunde cu JSON: {subiect, rezumat}."output_config={"format": {"type": "json_schema", "schema": SCHEMA}}Cu ieșire structurată, API-ul garantează JSON valid, cu rândurile noi escapate corect.
Repară eroarea, direct în pagină
Modelul rezumă un e-mail în JSON, dar pune un rând nou real în câmpul rezumat, iar json.loads cade cu Invalid control character at: line 1 column 79 (char 78). Repară parsarea cu strict=False și afișează Subiect: <subiect>, apoi rezumatul pe rândul următor, după Rezumat: .
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
r = client.messages.create(
model=MODEL,
max_tokens=300,
system="Rezumi e-mailurile clienților. Răspunzi cu JSON cu câmpurile subiect și rezumat.",
messages=[{"role": "user", "content": "Comanda 5521 a ajuns cu ecranul spart. Vreau alt produs, nu banii înapoi."}],
)
date = json.loads(r.content[0].text)
print("Subiect:", date["subiect"])
print("Rezumat:", date["rezumat"])Subiect: Comanda 5521 Rezumat: Clientul a primit produsul deteriorat. Cere înlocuirea lui.
Indiciu
json.loads(text, strict=False)
Reparația
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
r = client.messages.create(
model=MODEL,
max_tokens=300,
system="Rezumi e-mailurile clienților. Răspunzi cu JSON cu câmpurile subiect și rezumat.",
messages=[{"role": "user", "content": "Comanda 5521 a ajuns cu ecranul spart. Vreau alt produs, nu banii înapoi."}],
)
date = json.loads(r.content[0].text, strict=False) # acceptă rânduri noi reale în șiruri
print("Subiect:", date["subiect"])
print("Rezumat:", date["rezumat"])De ce merge
Parserul JSON din Python este strict implicit și respinge rândurile noi reale din interiorul șirurilor, deși modelul le-a pus acolo cu intenție. Cu strict=False, parserul acceptă caracterele de control din șiruri, iar rezumat păstrează rândul nou. Restul regulilor JSON rămân în vigoare, deci un JSON stricat în alt fel tot dă eroare.
Alte forme ale mesajului
json.decoder.JSONDecodeError: Invalid control character at: line 1 column 42 (char 41)json.decoder.JSONDecodeError: Invalid \escape: line 1 column 30 (char 29)
Cum o eviți pe viitor
- Pentru JSON cerut de la model, folosește ieșirea structurată, nu instrucțiuni în prompt.
- Când parsezi răspunsuri libere, folosește
strict=Falseși loghează textele care au avut nevoie de el. - Dacă JSON-ul ajunge în alte sisteme, re-serializează-l cu
json.dumps, care escapează corect.
Întrebări frecvente
Ce e varianta Invalid \escape?
O bară inversă urmată de un caracter care nu formează o secvență validă (\d, \s, căi Windows C:\Users). Aici strict=False nu ajută: barele trebuie dublate sau JSON-ul generat corect.
strict=False e sigur?
Da pentru caracterele de control din șiruri: le păstrează ca atare. Nu repară alte erori de sintaxă, cum ar fi ghilimele lipsă sau virgule în plus.
Erori înrudite
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) `json.loads` a primit un text care nu începe cu JSON: modelul a pus JSON-ul între ```json ... ``` sau a scris o propoziție înainte. Cere ieșire structurată (`output_config` cu `json_schema` la Claude, `text.format` la OpenAI) sau scoate marcajele înainte de `json.loads`. json.decoder.JSONDecodeError: Extra data: line 2 column 1 (char 41) Textul începe cu un JSON valid, dar după el mai urmează ceva: o explicație a modelului, un al doilea obiect sau un bloc de cod. json.loads acceptă un singur document. Cere ieșire structurată ca modelul să întoarcă doar JSON, sau extrage primul obiect cu json.JSONDecoder().raw_decode. json.decoder.JSONDecodeError: Unterminated string starting at: line 1 column 95 (char 94) JSON-ul de la model e tăiat la mijloc: răspunsul s-a oprit la `max_tokens` (`stop_reason == "max_tokens"`) înainte să închidă ghilimelele și acoladele. Mărește `max_tokens`, verifică `stop_reason` înainte de `json.loads` și cere câmpuri mai scurte. Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție
Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
