ERROR: duplicate key value violates unique constraint "produse_pkey"
Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană cu cheie primară sau UNIQUE. Linia DETAIL arată cheia duplicată. Un caz frecvent: secvența unei coloane identity/serial a rămas în urmă după inserări cu id-uri explicite, iar următorul id generat există deja.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul numește constrângerea încălcată (produse_pkey pentru cheia primară, clienti_email_key pentru o coloană UNIQUE), iar DETAIL: Key (id)=(4) already exists. arată valoarea exactă. Constrângerea e verificată la fiecare INSERT și UPDATE, iar instrucțiunea întreagă se anulează.
Două cauze domină. Prima: datele chiar se repetă (același email înregistrat de două ori, un import rulat de două ori); aici soluția este ON CONFLICT sau o verificare înainte. A doua, foarte des întâlnită: id-urile au fost inserate explicit (la un import sau dintr-un script de test), iar secvența din spatele coloanei identity/serial a rămas la o valoare mică. Următorul INSERT fără id primește un număr deja folosit. Reparația este SELECT setval(pg_get_serial_sequence('produse', 'id'), (SELECT max(id) FROM produse)).
De ce apare: cauzele frecvente
1Secvență rămasă în urmă după un import cu id-uri
INSERT INTO produse (id, nume, ...) VALUES (5, ...); -- import
INSERT INTO produse (nume, ...) VALUES (...); -- primește id 5SELECT setval(pg_get_serial_sequence('produse', 'id'), (SELECT max(id) FROM produse));
INSERT INTO produse (nume, ...) VALUES (...);setval aduce secvența la cel mai mare id existent.
2Valoare duplicată reală
INSERT INTO clienti VALUES (4, 'Ana P.', 'ana@exemplu.ro', 'Cluj');INSERT INTO clienti VALUES (4, 'Ana P.', 'ana@exemplu.ro', 'Cluj')
ON CONFLICT (email) DO NOTHING;ON CONFLICT tratează duplicatul fără eroare.
3UPDATE care creează un duplicat
UPDATE clienti SET email = 'ana@exemplu.ro' WHERE id = 2;SELECT id FROM clienti WHERE email = 'ana@exemplu.ro'; -- verifici întâiConstrângerea protejează unicitatea și la modificări.
Repară eroarea, direct în pagină
Produsele au fost importate cu id-uri explicite, iar secvența coloanei identity a rămas în urmă. Adăugarea unui produs nou dă duplicate key value violates unique constraint "produse_pkey". Resincronizează secvența cu cel mai mare id existent, inserează produsul și afișează id-ul și numele produselor.
INSERT INTO produse (nume, pret, stoc, categorie) VALUES ('Boxe', 159.00, 6, 'Accesorii');
SELECT id, nume FROM produse ORDER BY id; setval
--------
6
(1 rând)
INSERT 0 1
id | nume
----+--------------------
1 | Laptop Nova
2 | Mouse Wireless
3 | Tastatură Mecanică
4 | Monitor 27
5 | Căști
6 | Webcam
7 | Boxe
(7 rânduri)Indiciu
setval(pg_get_serial_sequence('produse', 'id'), (SELECT max(id) FROM produse))
Reparația
SELECT setval(pg_get_serial_sequence('produse', 'id'), (SELECT max(id) FROM produse));
INSERT INTO produse (nume, pret, stoc, categorie) VALUES ('Boxe', 159.00, 6, 'Accesorii');
SELECT id, nume FROM produse ORDER BY id;De ce merge
Importul a inserat id-urile 1–6 explicit, dar secvența a rămas la 4, deci următorul id generat ar fi fost 5, deja folosit. setval cu max(id) mută secvența la 6, iar produsul nou primește id-ul 7. Același pas trebuie rulat după orice import sau restaurare parțială cu id-uri explicite.
Alte forme ale mesajului
ERROR: duplicate key value violates unique constraint "clienti_email_key"
Cum o eviți pe viitor
- Lasă baza de date să genereze id-urile; nu insera id-uri explicite în coloanele identity.
- După importuri cu id-uri, resincronizează secvențele cu
setval. - Folosește
ON CONFLICT DO NOTHINGsauDO UPDATEpentru operații care pot fi repetate. - Tratează în aplicație codul SQLSTATE
23505și răspunde cu un mesaj clar („emailul există deja”).
Întrebări frecvente
Cum aflu valoarea curentă a secvenței?
SELECT last_value FROM produse_id_seq; sau SELECT pg_sequence_last_value('produse_id_seq'). Numele îl afli cu pg_get_serial_sequence('produse', 'id').
De ce după un ROLLBACK id-urile au „găuri”?
Secvențele nu se anulează la ROLLBACK, pentru a nu bloca alte tranzacții. Găurile sunt normale și nu trebuie „reparate”.
Erori înrudite
ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification Coloanele din ON CONFLICT (coloana) nu au o constrângere UNIQUE, cheie primară sau index unic exact pe ele. PostgreSQL are nevoie de o asemenea constrângere ca să detecteze conflictul. Creează constrângerea sau indexul unic, ori folosește în ON CONFLICT coloanele care au deja unul. 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. ERROR: could not create unique index "clienti_email_key" Încerci să adaugi o constrângere UNIQUE (sau un index unic, sau o cheie primară) pe o coloană care are deja valori duplicate. DETAIL arată prima pereche duplicată. Găsește și rezolvă duplicatele (șterge, combină sau corectează), apoi creează din nou constrângerea. Î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.
