ERROR: invalid input syntax for type json
Textul trimis într-o coloană json/jsonb nu este JSON valid: virgulă după ultimul element, ghilimele simple în loc de duble, chei fără ghilimele, NaN sau comentarii. DETAIL arată tokenul problematic. Generează JSON-ul cu o bibliotecă sau cu jsonb_build_object, nu prin concatenare de texte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
PostgreSQL validează strict JSON-ul la intrare, după standardul RFC 8259. Mesajul vine cu DETAIL: Token "..." is invalid. și CONTEXT: JSON data, line 1: ..., care arată unde s-a oprit parserul. Greșeli tipice: virgula după ultimul element ({"a": 1,}), ghilimele simple ({'a': 1}), chei fără ghilimele ({a: 1}), valori ca NaN, undefined sau comentarii, ghilimele neescapate în texte, texte goale.
Cauza de fond este aproape mereu construirea JSON-ului prin concatenare de texte, în SQL sau în aplicație. În SQL, folosește funcțiile jsonb_build_object, jsonb_build_array, to_jsonb și jsonb_agg, care escapează corect orice valoare. În aplicație, folosește biblioteca JSON a limbajului. În PostgreSQL 16+, pg_input_is_valid(text, 'jsonb') verifică un text fără să arunce eroare, util la importuri.
De ce apare: cauzele frecvente
1Virgulă după ultimul element
INSERT INTO evenimente (date) VALUES ('{"tip": "login",}');INSERT INTO evenimente (date) VALUES ('{"tip": "login"}');JSON nu permite virgula finală.
2JSON construit prin concatenare
SELECT ('{"nume": "' || nume || '"}')::jsonb FROM clienti; -- strică la ghilimeleSELECT jsonb_build_object('nume', nume) FROM clienti;Funcția escapează corect orice valoare.
3Ghilimele simple
SELECT '{''tip'': ''login''}'::jsonb;SELECT '{"tip": "login"}'::jsonb;Cheile și textele JSON folosesc ghilimele duble.
Repară eroarea, direct în pagină
Scriptul adaugă o comandă nouă în comenzi_json, dar documentul scris de mână are o virgulă după ultima cheie și dă invalid input syntax for type json. Construiește documentul cu jsonb_build_object (chei client, plata, total) și afișează plata și totalul comenzii 4.
INSERT INTO comenzi_json VALUES (4, '{"client": {"nume": "Radu Stan"}, "plata": "card", "total": "99.00",}');
SELECT doc->>'plata' AS plata, doc->>'total' AS total FROM comenzi_json WHERE id = 4;INSERT 0 1 plata | total -------+------- card | 99.00 (1 rând)
Indiciu
jsonb_build_object('client', jsonb_build_object('nume', 'Radu Stan'), 'plata', 'card', 'total', '99.00')
Reparația
INSERT INTO comenzi_json VALUES (4, jsonb_build_object(
'client', jsonb_build_object('nume', 'Radu Stan'),
'plata', 'card',
'total', '99.00'));
SELECT doc->>'plata' AS plata, doc->>'total' AS total FROM comenzi_json WHERE id = 4;De ce merge
Virgula de după ultima cheie face textul JSON invalid. jsonb_build_object construiește documentul din perechi cheie–valoare și produce mereu JSON corect, cu ghilimele escapate automat. Totalul rămâne text JSON, ca în celelalte documente, iar interogarea finală citește cheile cu ->>. Aceeași abordare elimină și problemele cu ghilimele din nume, care ar strica un JSON scris de mână.
Cum o eviți pe viitor
- Construiește JSON cu
jsonb_build_object/jsonb_aggîn SQL și cu biblioteci dedicate în aplicații. - Nu concatena texte pentru a produce JSON.
- La importuri, verifică validitatea cu
pg_input_is_valid(text, 'jsonb')și separă rândurile invalide. - Folosește
jsonb_prettydoar pentru afișare; stocarea nu are nevoie de formatare.
Întrebări frecvente
Ce diferență e între json și jsonb la validare?
Ambele validează sintaxa. json păstrează textul exact (inclusiv chei duplicate și spații), jsonb îl transformă într-o formă binară, fără duplicate, mai rapidă la interogare.
Acceptă PostgreSQL comentarii în JSON?
Nu. Comentariile nu fac parte din standardul JSON.
Erori înrudite
ERROR: invalid input syntax for type integer: "abc" Un text care nu e număr întreg ajunge într-o coloană sau expresie de tip integer: un câmp gol (''), un text ca 'abc', un număr cu zecimale ('12.5') sau cu spații. Curăță sau validează valoarea înainte de conversie; pentru câmpuri goale, folosește NULLIF(valoare, ''). ERROR: cannot cast jsonb string to type integer Încerci să convertești direct o valoare jsonb care este un text JSON ("12") în număr. Conversia directă jsonb → integer/numeric merge doar pentru numere JSON. Extrage valoarea ca text cu ->> și convertește textul: (doc->>'total')::numeric. ERROR: column "data" is of type date but expression is of type text Inserezi sau actualizezi o coloană cu o valoare care are deja tipul text (dintr-o coloană text, dintr-o funcție sau dintr-un parametru tipizat ca text), iar PostgreSQL nu o convertește implicit. Convertește explicit valoarea (valoare::date) sau trimite parametrul cu tipul corect. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
