Referential integrity constraint violation: "FK_PRODUS_CATEGORIE: PUBLIC.PRODUS FOREIGN KEY(CATEGORIE_ID) REFERENCES PUBLIC.CATEGORIE(ID)"
Ai încercat să ștergi un rând (o categorie) la care încă trimit alte rânduri prin cheie străină (produsele). Baza de date refuză, iar Spring aruncă DataIntegrityViolationException. Șterge sau mută întâi copiii, folosește cascade, ori răspunde 409 dacă ștergerea nu e permisă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la baza de date (aici H2, folosită în dezvoltare și în teste). Tabela produs are coloana categorie_id, o cheie străină spre categorie(id). Baza de date garantează că fiecare produs indică o categorie existentă, deci nu te lasă să ștergi o categorie care mai are produse (și nici să pui un categorie_id inexistent).
Hibernate primește eroarea la delete from categorie, iar Spring o traduce în DataIntegrityViolationException: could not execute statement [...]. Neprinsă, devine 500.
Numele constrângerii (FK_PRODUS_CATEGORIE sau un nume generat, ca FK1x2y...) și partea FOREIGN KEY(CATEGORIE_ID) REFERENCES PUBLIC.CATEGORIE(ID) îți spun ce tabele sunt implicate: tabela copil e prima, tabela părinte e după REFERENCES. Decide apoi regula de business: ștergi și copiii, îi muți, sau refuzi ștergerea.
De ce apare: cauzele frecvente
1Ștergi părintele care încă are copii
void sterge(long id) {
categorii.deleteById(id);
}void sterge(long id) {
if (produse.existsByCategorieId(id)) {
throw new ResponseStatusException(HttpStatus.CONFLICT, "Categoria are produse");
}
categorii.deleteById(id);
}Verifici regula înainte de ștergere și răspunzi cu un 409 clar, în locul unei erori 500 din baza de date.
2Copiii trebuie să dispară odată cu părintele
@OneToMany(mappedBy = "categorie")
private List<Produs> produse;@OneToMany(mappedBy = "categorie", cascade = CascadeType.REMOVE)
private List<Produs> produse;Cu cascade = REMOVE, Hibernate șterge întâi produsele, apoi categoria, deci constrângerea e respectată.
3Inserezi un copil cu un părinte inexistent
INSERT INTO produs (id, nume, categorie_id) VALUES (1, 'Mouse', 9);INSERT INTO categorie (id, nume) VALUES (9, 'Periferice');
INSERT INTO produs (id, nume, categorie_id) VALUES (1, 'Mouse', 9);Același mesaj apare și la inserare, când categorie_id nu există încă în tabela părinte.
Repară eroarea, direct în pagină
DELETE /categorii/1 răspunde 500 cu Referential integrity constraint violation, pentru că în categoria 1 sunt încă produse. Regula magazinului: o categorie cu produse nu se șterge. Răspunde atunci cu 409 și mesajul Categoria 1 are produse; categoria 2, goală, se șterge normal (204).
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.http.HttpStatus;
import org.springframework.web.server.ResponseStatusException;
import org.springframework.data.jpa.repository.JpaRepository;
import jakarta.persistence.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Categorie {
@Id @GeneratedValue
private Long id;
private String nume;
protected Categorie() { }
public Long getId() { return id; }
public String getNume() { return nume; }
}
@Entity
class Produs {
@Id @GeneratedValue
private Long id;
private String nume;
@ManyToOne
private Categorie categorie;
protected Produs() { }
public Long getId() { return id; }
public String getNume() { return nume; }
}
interface CategorieRepository extends JpaRepository<Categorie, Long> { }
interface ProdusRepository extends JpaRepository<Produs, Long> {
boolean existsByCategorieId(Long categorieId);
}
@RestController
class CategorieController {
private final CategorieRepository categorii;
private final ProdusRepository produse;
CategorieController(CategorieRepository categorii, ProdusRepository produse) {
this.categorii = categorii;
this.produse = produse;
}
@DeleteMapping("/categorii/{id}")
@ResponseStatus(HttpStatus.NO_CONTENT)
void sterge(@PathVariable long id) {
// TODO: o categorie care mai are produse nu se șterge: răspunde 409
categorii.deleteById(id);
}
}Tomcat started on port 8080 (http)
Started Application
DELETE /categorii/1 → 409
{"status":409,"error":"Conflict","message":"Categoria 1 are produse","path":"/categorii/1"}
DELETE /categorii/2 → 204Indiciu
Înainte de deleteById, întreabă repository-ul de produse dacă există produse în categoria respectivă.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.http.HttpStatus;
import org.springframework.web.server.ResponseStatusException;
import org.springframework.data.jpa.repository.JpaRepository;
import jakarta.persistence.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Categorie {
@Id @GeneratedValue
private Long id;
private String nume;
protected Categorie() { }
public Long getId() { return id; }
public String getNume() { return nume; }
}
@Entity
class Produs {
@Id @GeneratedValue
private Long id;
private String nume;
@ManyToOne
private Categorie categorie;
protected Produs() { }
public Long getId() { return id; }
public String getNume() { return nume; }
}
interface CategorieRepository extends JpaRepository<Categorie, Long> { }
interface ProdusRepository extends JpaRepository<Produs, Long> {
boolean existsByCategorieId(Long categorieId);
}
@RestController
class CategorieController {
private final CategorieRepository categorii;
private final ProdusRepository produse;
CategorieController(CategorieRepository categorii, ProdusRepository produse) {
this.categorii = categorii;
this.produse = produse;
}
@DeleteMapping("/categorii/{id}")
@ResponseStatus(HttpStatus.NO_CONTENT)
void sterge(@PathVariable long id) {
if (produse.existsByCategorieId(id)) {
throw new ResponseStatusException(HttpStatus.CONFLICT, "Categoria " + id + " are produse");
}
categorii.deleteById(id);
}
}De ce merge
Baza de date refuza ștergerea, pentru că produsele trimiteau prin cheia străină categorie_id spre categoria 1, iar eroarea ajungea la client ca 500. Acum controller-ul verifică întâi cu existsByCategorieId și, dacă găsește produse, aruncă ResponseStatusException cu CONFLICT. Clientul primește un 409 cu motivul, iar o categorie goală se șterge fără probleme.
Alte forme ale mesajului
org.springframework.dao.DataIntegrityViolationException: could not execute statement [Referential integrity constraint violation: "FK...: PUBLIC.PRODUS FOREIGN KEY(CATEGORIE_ID) REFERENCES PUBLIC.CATEGORIE(ID) (CAST(1 AS BIGINT))"]ERROR: update or delete on table "categorie" violates foreign key constraint "fk_produs_categorie" on table "produs"Cannot delete or update a parent row: a foreign key constraint fails
Cum o eviți pe viitor
- Stabilește pentru fiecare relație ce se întâmplă la ștergerea părintelui: refuz, cascade sau mutare.
- Verifică regula în service (
existsBy...) și răspunde 409 Conflict, nu 500. - Prinde
DataIntegrityViolationExceptionîntr-un@RestControllerAdvice, ca plasă de siguranță. - În
data.sql, inserează întâi tabelele părinte, apoi copiii.
Întrebări frecvente
De ce mesajul diferă în PostgreSQL sau MySQL?
Fiecare bază de date își formulează mesajul, dar cauza e aceeași: o cheie străină ar rămâne fără rândul spre care trimite. În PostgreSQL vezi violates foreign key constraint, în MySQL a foreign key constraint fails.
Pot dezactiva constrângerea ca să scap de eroare?
Nu e o idee bună: ai rămâne cu produse care trimit spre categorii inexistente. Constrângerea te protejează de date inconsistente; repară regula de ștergere.
Erori înrudite
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. 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ă. A collection with cascade="all-delete-orphan" was no longer referenced by the owning entity instance: Comanda.linii Pe o colecție cu orphanRemoval = true ai înlocuit lista cu una nouă (setLinii(new ArrayList<>())). Hibernate urmărește lista originală ca să știe ce rânduri să șteargă și refuză înlocuirea. Modifică lista existentă: getLinii().clear(), apoi addAll(...). Î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.
