...
Eroare Spring Boot · Spring Data JPA: entități și baza de date

Unique index or primary key violation: "PUBLIC.UK_PRODUS_COD ON PUBLIC.PRODUS(COD)"

Pe scurt

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ă

Greșit
JAVA
repo.save(new Produs("A1", "Mouse"));
repo.save(new Produs("A1", "Tastatură"));
Corect
JAVA
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

Greșit
JAVA
INSERT INTO produs (id, cod) VALUES (1, 'A1'), (2, 'B2');
-- apoi repo.save(...) primește id = 1
Corect
JAVA
INSERT INTO produs (cod) VALUES ('A1'), ('B2');
-- sau id-uri mari (1001, 1002) în scripturile de test

Secvenț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

Greșit
JAVA
if (!repo.existsByCod(cod)) {
    repo.save(p); // a doua cerere ajunge tot aici
}
Corect
JAVA
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ă tu

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.

Codul care dă eroarea
JAVA
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())));
    }
}
După reparație, programul afișează
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.

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 unique pe 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

← Toate erorile Spring Boot

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