The given id must not be null
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
record ProdusNou(String nume, Long categorieId) { }
// JSON: {"nume": "Mouse"}
categorii.findById(p.categorieId());record ProdusNou(String nume, @NotNull Long categorieId) { }
// cu @Valid pe @RequestBody: 400 înainte de findByIdValidarea oprește cererea fără id cu un mesaj clar, în loc de 500.
2Parametrul opțional este folosit direct
@GetMapping("/produse")
List<Produs> lista(@RequestParam(required = false) Long categorie) {
return List.of(repo.findById(categorie).orElseThrow());
}@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
Categorie c = new Categorie("Birou");
repo.existsById(c.getId());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ă 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.
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);
}
}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.
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.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) {
if (categorie == null) {
return repo.findAll();
}
return repo.findByCategorieId(categorie);
}
}De ce merge
@RequestParam(required = false) lasă parametrul null când lipsește din adresă, iar findById(null) aruncă imediat The given id must not be null. Acum metoda tratează explicit lipsa filtrului și întoarce toate produsele; doar când filtrul există, caută după categorie. Apelul findById nici nu era necesar aici.
Alte forme ale mesajului
org.springframework.dao.InvalidDataAccessApiUsageException: The given id must not be nulljava.lang.IllegalArgumentException: The given id must not be nullThe 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
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. 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ă. Î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.
