ERROR: invalid input syntax for type uuid: "123"
Valoarea trimisă într-o coloană uuid nu are formatul de UUID (32 de cifre hexazecimale, de obicei grupate 8-4-4-4-12). Apare când aplicația trimite un id numeric, un text gol sau un id cu caractere în plus. Verifică valoarea și generează UUID-uri cu gen_random_uuid() sau uuidv7().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tipul uuid acceptă doar 128 de biți scriși hexazecimal, cu sau fără cratime, eventual între acolade. Orice altceva ("123", "", "abc-def", un UUID cu spațiu la final venit dintr-un formular) dă această eroare, cu valoarea afișată în mesaj.
Situații frecvente: o rută din API primește /comenzi/123 în loc de un UUID, iar codul trimite direct parametrul în interogare; un câmp opțional gol e trimis ca '' în loc de NULL; o coloană text cu id-uri amestecate e convertită la uuid. În aplicație, validează formatul înainte de interogare și răspunde cu 400 sau 404, nu cu o eroare de bază de date. În PostgreSQL, gen_random_uuid() (v4) și uuidv7() (PostgreSQL 18) generează valori corecte.
De ce apare: cauzele frecvente
1Id numeric trimis la o coloană uuid
SELECT * FROM comenzi_publice WHERE cod = '123';SELECT * FROM comenzi_publice WHERE cod = '0195a1b2-7c3d-7e4f-8a9b-0c1d2e3f4a5b';Coloana uuid acceptă doar identificatori în format UUID.
2Text gol în loc de NULL
INSERT INTO sesiuni (token) VALUES ('');INSERT INTO sesiuni (token) VALUES (NULL);
-- sau: VALUES (gen_random_uuid())Textul gol nu e un UUID; valoarea lipsă se scrie NULL.
3Generare manuală greșită
INSERT INTO sesiuni (token) VALUES ('sesiune-' || 42);INSERT INTO sesiuni (token) VALUES (gen_random_uuid());Lasă PostgreSQL să genereze UUID-ul.
Repară eroarea, direct în pagină
Tabelul sesiuni are coloana token uuid. Scriptul care creează o sesiune nouă pentru utilizatorul ana trimite un text gol ca token și dă invalid input syntax for type uuid: "". Lasă PostgreSQL să genereze tokenul, apoi afișează utilizatorul și dacă tokenul e completat.
INSERT INTO sesiuni (utilizator, token) VALUES ('ana', '');
SELECT utilizator, token IS NOT NULL AS are_token FROM sesiuni;INSERT 0 1 utilizator | are_token ------------+----------- ana | t (1 rând)
Indiciu
Există o funcție care generează un UUID nou.
Reparația
INSERT INTO sesiuni (utilizator, token) VALUES ('ana', gen_random_uuid());
SELECT utilizator, token IS NOT NULL AS are_token FROM sesiuni;De ce merge
Textul gol nu este un UUID valid. gen_random_uuid() generează un UUID versiunea 4, aleator, la fiecare apel. Pentru că valoarea e diferită la fiecare rulare, interogarea afișează doar dacă tokenul există (token IS NOT NULL), ca rezultatul să fie verificabil. În aplicații reale, tokenul ar avea DEFAULT gen_random_uuid() în definiția tabelului.
Cum o eviți pe viitor
- Generează UUID-urile în baza de date (
DEFAULT gen_random_uuid()sauuuidv7()) sau cu o bibliotecă standard în aplicație. - Validează parametrii din URL și formulare înainte să ajungă în SQL.
- Trimite NULL, nu text gol, pentru valorile lipsă.
- Stochează identificatorii în coloane
uuid, nutext: validarea se face automat, iar spațiul ocupat e mai mic.
Întrebări frecvente
Este UUID-ul case-sensitive?
Nu. PostgreSQL acceptă litere mari și mici și afișează mereu litere mici.
uuidv7 sau gen_random_uuid?
uuidv7() (PostgreSQL 18) produce valori ordonate în timp, mai prietenoase cu indecșii; gen_random_uuid() produce valori complet aleatoare. Ambele au același tip uuid.
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: operator does not exist: integer = text Compari o coloană numerică (integer) cu o valoare de tip text, de obicei o coloană text dintr-un tabel de import sau un parametru trimis ca text. PostgreSQL nu face conversia automat. Convertește explicit una dintre părți: cod_produs::int sau id::text. ERROR: cannot insert a non-DEFAULT value into column "id" Coloana e GENERATED ALWAYS AS IDENTITY (sau o coloană generată), iar INSERT-ul îi dă o valoare explicită. PostgreSQL nu permite asta. Scoate coloana din INSERT ca valoarea să fie generată, iar dacă trebuie neapărat să păstrezi id-uri (la o migrare), folosește OVERRIDING SYSTEM VALUE. Î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.
