...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: duplicate key value violates unique constraint "produse_pkey"

Pe scurt

Î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

Greșit
SQL
INSERT INTO produse (id, nume, ...) VALUES (5, ...);  -- import
INSERT INTO produse (nume, ...) VALUES (...);  -- primește id 5
Corect
SQL
SELECT 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ă

Greșit
SQL
INSERT INTO clienti VALUES (4, 'Ana P.', 'ana@exemplu.ro', 'Cluj');
Corect
SQL
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

Greșit
SQL
UPDATE clienti SET email = 'ana@exemplu.ro' WHERE id = 2;
Corect
SQL
SELECT id FROM clienti WHERE email = 'ana@exemplu.ro';  -- verifici întâi

Constrângerea protejează unicitatea și la modificări.

Repară tu

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.

Codul care dă eroarea
SQL
INSERT INTO produse (nume, pret, stoc, categorie) VALUES ('Boxe', 159.00, 6, 'Accesorii');
SELECT id, nume FROM produse ORDER BY id;
După reparație, programul afișează
 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))

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 NOTHING sau DO UPDATE pentru 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

← 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.