...
Eroare Spring Boot · Excepții și răspunsuri de eroare

Cannot invoke "Produs.nume()" because the return value of "java.util.Map.get(Object)" is null

Pe scurt

Ai apelat o metodă pe rezultatul lui map.get(cheie), dar cheia nu există și get a întors null, deci NullPointerException și 500. Verifică rezultatul înainte (sau folosește getOrDefault / Optional) și răspunde 404 pentru cheile lipsă.

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

Ce înseamnă

Mesajul este un NullPointerException cu explicația detaliată din Java 14+ (helpful NPE). Se citește așa: s-a încercat apelul Produs.nume(), dar obiectul pe care s-a apelat era null, iar acel null a venit din valoarea întoarsă de Map.get(Object).

Map.get întoarce null când cheia nu există. Într-un controller care caută după id într-o hartă (un catalog în memorie, un cache), un id inexistent produce exact această eroare, iar clientul primește 500 în loc de 404. Același tipar apare cu repository.findByCod(cod) care întoarce null, cu request.getHeader(...) pentru un antet lipsă sau cu orice metodă care poate întoarce null.

Mesajul îți spune direct sursa null-ului, deci nu mai trebuie să ghicești care dintre expresiile de pe linie era nulă.

De ce apare: cauzele frecvente

1Cheie inexistentă în hartă

Greșit
JAVA
return produse.get(id).nume();
Corect
JAVA
Produs p = produse.get(id);
if (p == null) {
    throw new ResponseStatusException(HttpStatus.NOT_FOUND);
}
return p.nume();

Verifici rezultatul înainte să-l folosești și răspunzi 404 pentru lipsă.

2Antet sau parametru opțional lipsă

Greșit
JAVA
String limba = request.getHeader("Accept-Language").substring(0, 2);
Corect
JAVA
String antet = request.getHeader("Accept-Language");
String limba = antet == null ? "ro" : antet.substring(0, 2);

getHeader întoarce null când antetul lipsește.

Repară tu

Repară eroarea, direct în pagină

GET /produse/7/nume răspunde 500, iar în log apare Cannot invoke "Produs.nume()" because the return value of "java.util.Map.get(Object)" is null. Verifică rezultatul lui get și răspunde 404 cu motivul Produsul 7 nu există pentru produsele lipsă.

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.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import org.springframework.web.server.ResponseStatusException;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

record Produs(String nume, double pret) {
}

@RestController
class ProdusController {
    private final Map<Long, Produs> produse = Map.of(1L, new Produs("Mouse", 89.9));

    @GetMapping("/produse/{id}/nume")
    String nume(@PathVariable long id) {
        return produse.get(id).nume();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse/1/nume → 200
Mouse
GET /produse/7/nume → 404
{"status":404,"error":"Not Found","message":"Produsul 7 nu există","path":"/produse/7/nume"}
Indiciu

Salvează rezultatul lui get într-o variabilă și verifică dacă e null.

Alte forme ale mesajului

  • Cannot invoke "String.length()" because "nume" is null
  • Cannot invoke "Produs.getPret()" because "produs" is null

Cum o eviți pe viitor

  • Tratează explicit valorile care pot lipsi: getOrDefault, Optional, verificare cu if.
  • În repository-uri, întoarce Optional<T> în loc de null.
  • Răspunde 404 pentru resursele lipsă, nu lăsa NPE să devină 500.
  • Citește mereu partea because ... a mesajului: îți spune sursa null-ului.

Întrebări frecvente

De ce nu văd mesajul detaliat?

Mesajele detaliate există din Java 14 și sunt active implicit din Java 15. Pe versiuni mai vechi vezi doar NullPointerException.

Ce diferență e între get și getOrDefault?

getOrDefault(cheie, valoare) întoarce valoarea dată când cheia lipsește, în loc de null.

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.