java.lang.NullPointerException: element cannot be mapped to a null key
Collectors.groupingBy a primit cheia null pentru un element, de exemplu un client fără oraș. Grupările nu acceptă chei null: filtrează elementele fără valoare sau înlocuiește null cu un text, ca "necunoscut".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Collectors.groupingBy(functie) aplică funcția fiecărui element ca să afle grupa lui, apoi pune elementul în harta rezultată sub acea cheie. Dacă funcția întoarce null pentru măcar un element, colectorul se oprește cu NullPointerException: element cannot be mapped to a null key.
Cauza e în date: un câmp necompletat (oraș, categorie, departament) sau o metodă care întoarce null în anumite cazuri. Stiva arată Collectors.lambda$groupingBy și, mai jos, linia cu collect din codul tău.
Hotărăște ce înseamnă un element fără grupă: îl elimini (filter(p -> p.oras() != null)), îl pui într-o grupă separată (p.oras() == null ? "necunoscut" : p.oras()) sau îl repari mai devreme, la citirea datelor. Collectors.toMap are o problemă asemănătoare cu valorile null.
De ce apare: cauzele frecvente
1Câmp null folosit drept cheie
Map<String, Long> pe = clienti.stream()
.collect(Collectors.groupingBy(Client::oras, Collectors.counting()));Map<String, Long> pe = clienti.stream()
.collect(Collectors.groupingBy(
c -> c.oras() == null ? "necunoscut" : c.oras(),
Collectors.counting()));Clienții fără oraș primesc o cheie text, deci niciun element nu mai ajunge la o cheie null.
2Elementele fără grupă nu trebuie numărate
clienti.stream().collect(Collectors.groupingBy(Client::oras));clienti.stream()
.filter(c -> c.oras() != null)
.collect(Collectors.groupingBy(Client::oras));Filtrul elimină elementele fără oraș înainte de grupare.
Repară eroarea, direct în pagină
Programul numără clienții pe orașe, dar un client nu are orașul completat și programul se oprește cu NullPointerException: element cannot be mapped to a null key. Pune clienții fără oraș în grupa necunoscut, ca programul să afișeze {Cluj=2, Iasi=1, necunoscut=1}.
import java.util.List;
import java.util.Map;
import java.util.TreeMap;
import java.util.stream.Collectors;
public class Main {
record Client(String nume, String oras) {
}
public static void main(String[] args) {
List<Client> clienti = List.of(
new Client("Ana", "Cluj"),
new Client("Dan", "Iasi"),
new Client("Ioana", null),
new Client("Mihai", "Cluj"));
Map<String, Long> peOrase = clienti.stream()
.collect(Collectors.groupingBy(Client::oras, TreeMap::new, Collectors.counting()));
System.out.println(peOrase);
}
}{Cluj=2, Iasi=1, necunoscut=1}Indiciu
În funcția de grupare, întoarce "necunoscut" când oras() este null.
Reparația
import java.util.List;
import java.util.Map;
import java.util.TreeMap;
import java.util.stream.Collectors;
public class Main {
record Client(String nume, String oras) {
}
public static void main(String[] args) {
List<Client> clienti = List.of(
new Client("Ana", "Cluj"),
new Client("Dan", "Iasi"),
new Client("Ioana", null),
new Client("Mihai", "Cluj"));
Map<String, Long> peOrase = clienti.stream()
.collect(Collectors.groupingBy(
c -> c.oras() == null ? "necunoscut" : c.oras(),
TreeMap::new,
Collectors.counting()));
System.out.println(peOrase);
}
}De ce merge
Client::oras întorcea null pentru Ioana, iar groupingBy refuză cheile null. Funcția nouă înlocuiește lipsa orașului cu textul necunoscut, deci fiecare client are o cheie validă. TreeMap::new păstrează cheile sortate, iar counting() numără clienții din fiecare grupă.
Alte forme ale mesajului
Exception in thread "main" java.lang.NullPointerException: element cannot be mapped to a null key at java.base/java.util.Objects.requireNonNull(Objects.java)
Cum o eviți pe viitor
- Înainte de
groupingBy, întreabă-te dacă cheia poate lipsi pentru vreun element. - Validează datele la intrare: un câmp obligatoriu nu ar trebui să ajungă
nullîn obiecte. - Folosește
Optionalsau valori implicite în metodele care pot întoarce „nimic”. - Scrie un test cu un element incomplet, ca să vezi cum se comportă raportul.
Întrebări frecvente
Dar HashMap acceptă cheia null, de ce groupingBy nu?
E o decizie a colectorului: verifică explicit cheia cu Objects.requireNonNull. O cheie null într-un raport e de obicei un semn de date lipsă, nu o grupă reală.
Și partitioningBy?
partitioningBy folosește un predicat care întoarce true sau false, deci nu are chei null. Poate da însă alt NullPointerException dacă predicatul apelează metode pe un câmp null.
Erori înrudite
java.lang.NullPointerException: Cannot invoke "String.length()" because "nume" is null Ai apelat o metodă pe o variabilă care are valoarea null, adică nu indică spre niciun obiect. Mesajul spune ce metodă (String.length()) și care variabilă e null (nume): dă-i o valoare reală sau verifică if (nume != null) înainte de apel. java.lang.IllegalStateException: Duplicate key Cluj (attempted merging values Ana and Dan) Collectors.toMap a primit două elemente cu aceeași cheie și nu știe ce valoare să păstreze. Dă-i al treilea argument, funcția de combinare: toMap(k, v, (a, b) -> a), sau folosește groupingBy dacă vrei toate valorile. java.util.NoSuchElementException: No value present Ai apelat get() sau orElseThrow() pe un Optional gol, adică operația (findFirst, max, min, findAny) nu a găsit nimic. Folosește orElse(valoare), ifPresent(...) sau verifică isPresent() înainte. Învață Java de la zero, cu exerciții la fiecare lecție
Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
