...
Eroare SQL · Funcții JSON și text

malformed JSON

Pe scurt

O funcție JSON (json_extract, ->, ->>, json_each, json) a primit un text care nu e JSON valid: trunchiat, gol sau text simplu. Găsește rândul cu json_valid(coloana) = 0 și repară-l, sau sari peste el cu WHERE json_valid(coloana).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

SQLite are funcții JSON incluse: json_extract(text, '$.camp'), operatorii -> și ->>, json_each, json_object etc. Toate primesc JSON ca text. Când textul nu poate fi citit ca JSON, funcția oprește toată interogarea cu malformed JSON, chiar dacă doar un singur rând e stricat.

SQLite e destul de tolerant: din versiunea 3.42 acceptă și JSON5, deci virgula în plus la final și cheile fără ghilimele trec. Rămân erori:

  • textul tăiat ({"oras": "Iași" fără }), de obicei din coloane prea scurte sau importuri;
  • șirul gol '' sau un text care nu e JSON (n/a, -);
  • valori lipite din două obiecte.

Mesajul nu spune rândul. Găsește-l cu SELECT id FROM t WHERE json_valid(coloana) = 0;. NULL nu dă eroare: funcțiile întorc NULL.

De ce apare: cauzele frecvente

1Un rând cu JSON trunchiat

Greșit
SQL
SELECT id, json_extract(detalii, '$.oras')
FROM comenzi;
Corect
SQL
SELECT id, json_extract(detalii, '$.oras')
FROM comenzi
WHERE json_valid(detalii);

json_valid întoarce 1 doar pentru JSON corect. Rândurile stricate sunt sărite și le poți repara separat.

2Text gol în loc de NULL

Greșit
SQL
INSERT INTO comenzi (detalii) VALUES ('');
SELECT detalii ->> '$.oras' FROM comenzi;
Corect
SQL
INSERT INTO comenzi (detalii) VALUES (NULL);
SELECT detalii ->> '$.oras' FROM comenzi;

Pentru „fără detalii” folosește NULL. Funcțiile JSON întorc NULL pentru NULL, dar dau eroare pentru textul gol.

Repară tu

Repară eroarea, direct în pagină

Tabelul comenzi are în coloana detalii datele de livrare în format JSON, dar o comandă are JSON-ul tăiat. Interogarea care afișează id și orașul (oras) dă acum malformed JSON. Repar-o ca să afișeze orașul doar pentru comenzile cu JSON valid, ordonate după id.

Codul care dă eroarea
SQL
SELECT id, json_extract(detalii, '$.oras') AS oras
FROM comenzi
ORDER BY id;
După reparație, programul afișează
id | oras
1 | Iași
3 | Cluj-Napoca
Indiciu

Există o funcție care spune dacă un text e JSON valid.

Alte forme ale mesajului

  • sqlite3.OperationalError: malformed JSON
  • ERROR: invalid input syntax for type json
  • ERROR 3141 (22032): Invalid JSON text in argument 1 to function json_extract: "Missing a comma or '}' after an object member." at position 16.

Cum o eviți pe viitor

Validează JSON-ul la scriere, cu o constrângere: detalii TEXT CHECK (detalii IS NULL OR json_valid(detalii)). Așa niciun rând stricat nu intră în tabel. Construiește JSON-ul în aplicație cu biblioteca limbajului (json.dumps, JSON.stringify) sau în SQL cu json_object(...), nu prin lipire de texte. Folosește NULL pentru lipsa datelor, nu ''.

Întrebări frecvente

De ce pică toată interogarea pentru un singur rând?

Funcția dă eroare, nu NULL, ca să nu ascundă date stricate. Filtrează cu json_valid dacă vrei să sari peste ele.

Ce diferență e între -> și ->>?

-> întoarce JSON (de exemplu "Iași" cu ghilimele), ->> întoarce valoarea SQL (Iași), ca json_extract.

Erori înrudite

← Toate erorile SQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.