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

The given id must not be null

Pe scurt

Ai apelat findById, existsById sau deleteById cu un id null. Spring Data refuză din start și aruncă InvalidDataAccessApiUsageException (500). Verifică de unde vine id-ul: un parametru opțional, un câmp necompletat din DTO sau o entitate încă nesalvată.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Metodele CrudRepository care primesc un id îl verifică înainte să meargă la bază: Assert.notNull(id, "The given id must not be null"). Un id null nu poate identifica niciun rând, deci Spring aruncă IllegalArgumentException, tradusă în InvalidDataAccessApiUsageException: The given id must not be null. Fără tratare, clientul vede 500.

Aproape întotdeauna null-ul vine de mai sus: un @RequestParam(required = false) Long id necompletat, un câmp categorieId lipsă din JSON-ul cererii sau getId() apelat pe o entitate creată cu new și încă nesalvată (id-ul se generează abia la save).

Ca să găsești locul, caută în stiva de apeluri primul rând din codul tău (controller sau service) de sub SimpleJpaRepository.findById. Variabila trimisă acolo e cea goală.

De ce apare: cauzele frecvente

1Câmpul cu id lipsește din cerere

Greșit
JAVA
record ProdusNou(String nume, Long categorieId) { }
// JSON: {"nume": "Mouse"}
categorii.findById(p.categorieId());
Corect
JAVA
record ProdusNou(String nume, @NotNull Long categorieId) { }
// cu @Valid pe @RequestBody: 400 înainte de findById

Validarea oprește cererea fără id cu un mesaj clar, în loc de 500.

2Parametrul opțional este folosit direct

Greșit
JAVA
@GetMapping("/produse")
List<Produs> lista(@RequestParam(required = false) Long categorie) {
    return List.of(repo.findById(categorie).orElseThrow());
}
Corect
JAVA
@GetMapping("/produse")
List<Produs> lista(@RequestParam(required = false) Long categorie) {
    if (categorie == null) return repo.findAll();
    return repo.findByCategorieId(categorie);
}

Un parametru opțional poate lipsi; tratează explicit cazul null.

3Folosești id-ul unei entități nesalvate

Greșit
JAVA
Categorie c = new Categorie("Birou");
repo.existsById(c.getId());
Corect
JAVA
Categorie c = repo.save(new Categorie("Birou"));
repo.existsById(c.getId());

Cu @GeneratedValue, id-ul există doar după save; folosește obiectul întors de save.

Repară tu

Repară eroarea, direct în pagină

GET /produse fără parametrul categorie dă 500 cu The given id must not be null. Când parametrul lipsește, întoarce toate produsele; când există, doar produsele categoriei respective.

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.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;
    private String nume;
    private Long categorieId;

    protected Produs() {
    }

    public Long getId() { return id; }
    public String getNume() { return nume; }
    public Long getCategorieId() { return categorieId; }
}

interface ProdusRepository extends JpaRepository<Produs, Long> {
    List<Produs> findByCategorieId(Long categorieId);
}

@RestController
class ProdusController {
    private final ProdusRepository repo;

    ProdusController(ProdusRepository repo) {
        this.repo = repo;
    }

    @GetMapping("/produse")
    List<Produs> lista(@RequestParam(required = false) Long categorie) {
        repo.findById(categorie);
        return repo.findByCategorieId(categorie);
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse → 200
[{"id":1,"nume":"Mouse","categorieId":1},{"id":2,"nume":"Birou","categorieId":2},{"id":3,"nume":"Scaun","categorieId":2}]
GET /produse?categorie=2 → 200
[{"id":2,"nume":"Birou","categorieId":2},{"id":3,"nume":"Scaun","categorieId":2}]
Indiciu

Parametrul e opțional: tratează cazul null înainte să apelezi findById.

Alte forme ale mesajului

  • org.springframework.dao.InvalidDataAccessApiUsageException: The given id must not be null
  • java.lang.IllegalArgumentException: The given id must not be null
  • The given entity must not be null

Cum o eviți pe viitor

  • Validează id-urile obligatorii din DTO-uri cu @NotNull.
  • Pentru parametri opționali, scrie ramura pentru lipsa lor.
  • Folosește întotdeauna rezultatul lui save(...) când ai nevoie de id-ul generat.
  • Preferă Long id în @PathVariable (obligatoriu prin natura căii) pentru resursele identificate prin id.

Întrebări frecvente

De ce nu primesc NullPointerException?

Pentru că Spring Data verifică argumentul înainte să-l folosească și aruncă o excepție cu mesaj clar. E o protecție: îți spune exact care e problema.

Cum transform eroarea în 400?

Cel mai curat e să nu ajungi la ea: validare cu @NotNull pe DTO. Altfel, un @ExceptionHandler(IllegalArgumentException.class) poate răspunde 400, dar ascunde și alte erori de programare.

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.