...
Eroare Spring Boot · Relații și tranzacții

Referential integrity constraint violation: "FK_PRODUS_CATEGORIE: PUBLIC.PRODUS FOREIGN KEY(CATEGORIE_ID) REFERENCES PUBLIC.CATEGORIE(ID)"

Pe scurt

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

Greșit
JAVA
void sterge(long id) {
    categorii.deleteById(id);
}
Corect
JAVA
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

Greșit
JAVA
@OneToMany(mappedBy = "categorie")
private List<Produs> produse;
Corect
JAVA
@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

Greșit
JAVA
INSERT INTO produs (id, nume, categorie_id) VALUES (1, 'Mouse', 9);
Corect
JAVA
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ă tu

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

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

Înainte de deleteById, întreabă repository-ul de produse dacă există produse în categoria respectivă.

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

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