...
Eroare PostgreSQL · Tipuri de date, operatori și conversii

ERROR: invalid input syntax for type uuid: "123"

Pe scurt

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

Greșit
SQL
SELECT * FROM comenzi_publice WHERE cod = '123';
Corect
SQL
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

Greșit
SQL
INSERT INTO sesiuni (token) VALUES ('');
Corect
SQL
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ă

Greșit
SQL
INSERT INTO sesiuni (token) VALUES ('sesiune-' || 42);
Corect
SQL
INSERT INTO sesiuni (token) VALUES (gen_random_uuid());

Lasă PostgreSQL să genereze UUID-ul.

Repară tu

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.

Codul care dă eroarea
SQL
INSERT INTO sesiuni (utilizator, token) VALUES ('ana', '');
SELECT utilizator, token IS NOT NULL AS are_token FROM sesiuni;
După reparație, programul afișează
INSERT 0 1
 utilizator | are_token
------------+-----------
 ana        | t
(1 rând)
Indiciu

Există o funcție care generează un UUID nou.

Cum o eviți pe viitor

  • Generează UUID-urile în baza de date (DEFAULT gen_random_uuid() sau uuidv7()) 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, nu text: 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

← Toate erorile PostgreSQL

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ță 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.