Unique index or primary key violation: "PUBLIC.UK_PRODUS_COD ON PUBLIC.PRODUS(COD)"
Ai încercat să salvezi un rând cu o valoare care există deja într-o coloană unică (sau cu o cheie primară deja folosită). Baza de date refuză, iar Spring aruncă DataIntegrityViolationException, adică 500. Verifică înainte cu existsBy... și răspunde 409, sau tratează excepția.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la H2: instrucțiunea insert sau update ar fi creat un duplicat într-un index unic. Partea dintre ghilimele numește constrângerea și coloana (PRODUS(COD)), iar varianta PRIMARY KEY ON PUBLIC.PRODUS(ID) înseamnă că s-a repetat chiar cheia primară.
În Spring, eroarea ajunge ca DataIntegrityViolationException: could not execute statement [...]. Dacă nu o tratezi, clientul primește 500, deși problema e în datele trimise de el. Constrângerea există pentru că ai pus @Column(unique = true) pe câmp (sau un index unic în schemă), și e bine că există: este ultima linie de apărare împotriva duplicatelor.
Cazul cu cheia primară apare des când data.sql inserează rânduri cu id-uri fixe, iar apoi save() generează id-uri care încep tot de la 1.
De ce apare: cauzele frecvente
1Salvezi fără să verifici dacă valoarea există
repo.save(new Produs("A1", "Mouse"));
repo.save(new Produs("A1", "Tastatură"));if (repo.existsByCod("A1")) {
return ResponseEntity.status(409).build();
}
repo.save(new Produs("A1", "Tastatură"));Verificarea în cod îți permite să răspunzi cu un mesaj clar și cu 409 Conflict, în loc de 500.
2data.sql folosește id-uri pe care le generează și Hibernate
INSERT INTO produs (id, cod) VALUES (1, 'A1'), (2, 'B2');
-- apoi repo.save(...) primește id = 1INSERT INTO produs (cod) VALUES ('A1'), ('B2');
-- sau id-uri mari (1001, 1002) în scripturile de testSecvența Hibernate nu știe de rândurile inserate cu id fix, așa că poate genera un id deja ocupat.
3Două cereri simultane trec amândouă de verificare
if (!repo.existsByCod(cod)) {
repo.save(p); // a doua cerere ajunge tot aici
}try {
repo.saveAndFlush(p);
} catch (DataIntegrityViolationException e) {
return ResponseEntity.status(409).build();
}Verificarea nu e atomică; doar constrângerea din bază garantează unicitatea, deci prinde și excepția.
Repară eroarea, direct în pagină
POST /produse cu un cod existent dă 500 cu Unique index or primary key violation. Verifică înainte de salvare dacă există deja un produs cu acel cod și răspunde atunci cu 409 și textul Codul A1 există deja.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
@Column(unique = true)
private String cod;
private String nume;
protected Produs() {
}
Produs(String cod, String nume) {
this.cod = cod;
this.nume = nume;
}
public Long getId() { return id; }
public String getCod() { return cod; }
public String getNume() { return nume; }
}
record ProdusNou(String cod, String nume) { }
interface ProdusRepository extends JpaRepository<Produs, Long> {
boolean existsByCod(String cod);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@PostMapping("/produse")
ResponseEntity<?> adauga(@RequestBody ProdusNou p) {
// TODO: dacă există deja un produs cu acest cod, răspunde 409
return ResponseEntity.status(201).body(repo.save(new Produs(p.cod(), p.nume())));
}
}Tomcat started on port 8080 (http)
Started Application
POST /produse → 201
{"id":1,"cod":"A1","nume":"Mouse"}
POST /produse → 409
Codul A1 există deja
POST /produse → 201
{"id":2,"cod":"B2","nume":"Tastatură"}Indiciu
Repository-ul are deja metoda existsByCod; folosește-o înainte de save.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
@Column(unique = true)
private String cod;
private String nume;
protected Produs() {
}
Produs(String cod, String nume) {
this.cod = cod;
this.nume = nume;
}
public Long getId() { return id; }
public String getCod() { return cod; }
public String getNume() { return nume; }
}
record ProdusNou(String cod, String nume) { }
interface ProdusRepository extends JpaRepository<Produs, Long> {
boolean existsByCod(String cod);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@PostMapping("/produse")
ResponseEntity<?> adauga(@RequestBody ProdusNou p) {
if (repo.existsByCod(p.cod())) {
return ResponseEntity.status(409).body("Codul " + p.cod() + " există deja");
}
return ResponseEntity.status(201).body(repo.save(new Produs(p.cod(), p.nume())));
}
}De ce merge
Constrângerea unique din bază oprea al doilea insert, iar excepția neprinsă devenea 500. Acum service-ul întreabă întâi baza (existsByCod) și răspunde cu 409 și un mesaj pe care clientul îl poate afișa. Constrângerea rămâne pe câmp: ea protejează datele și când două cereri ajung în același timp.
Alte forme ale mesajului
Unique index or primary key violation: "PRIMARY KEY ON PUBLIC.PRODUS(ID)"ERROR: duplicate key value violates unique constraint "uk_produs_cod"Duplicate entry 'A1' for key 'produs.uk_produs_cod'org.springframework.dao.DataIntegrityViolationException: could not execute statement
Cum o eviți pe viitor
- Pune constrângeri
uniquepe coloanele care trebuie să fie unice (cod, email, CNP). - În service, verifică existența (
existsByCod) și răspunde 409 cu un mesaj clar. - Tratează și
DataIntegrityViolationExceptionîntr-un@RestControllerAdvice, pentru cazurile concurente. - În
data.sql, nu fixa id-uri pe care le generează și aplicația.
Întrebări frecvente
Ce cod HTTP dau pentru un duplicat?
409 Conflict: cererea e corectă ca format, dar intră în conflict cu starea resursei. 400 se folosește pentru date invalide (un câmp lipsă, un format greșit).
De ce nu primesc eroarea la save(), ci mai târziu?
Într-o tranzacție, Hibernate amână insert-ul până la flush (la final sau înaintea unei interogări). Cu saveAndFlush eroarea apare imediat, unde o poți prinde.
Erori înrudite
NULL not allowed for column "NUME" Încerci să salvezi o entitate cu null într-o coloană declarată NOT NULL (de exemplu @Column(nullable = false)). Baza refuză inserarea și primești DataIntegrityViolationException, deci 500. Validează datele înainte (@NotBlank cu @Valid) sau setează valoarea lipsă. Value too long for column "NUME CHARACTER VARYING(20)" Textul salvat are mai multe caractere decât lungimea coloanei (implicit 255, sau cât ai pus în @Column(length = ...)). Baza refuză inserarea cu DataIntegrityViolationException. Validează lungimea la intrare cu @Size(max = ...) și ține aceeași limită în entitate. ids for this class must be manually assigned before calling save(): Produs Entitatea are @Id fără @GeneratedValue, deci Hibernate așteaptă ca tu să setezi id-ul. L-ai lăsat null și ai apelat save(). Adaugă @GeneratedValue pe id (dacă baza trebuie să-l genereze) sau setează id-ul înainte de salvare. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
