...
Eroare Java · Colecții și Stream API

java.lang.NullPointerException: element cannot be mapped to a null key

Pe scurt

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

Greșit
JAVA
Map<String, Long> pe = clienti.stream()
    .collect(Collectors.groupingBy(Client::oras, Collectors.counting()));
Corect
JAVA
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

Greșit
JAVA
clienti.stream().collect(Collectors.groupingBy(Client::oras));
Corect
JAVA
clienti.stream()
    .filter(c -> c.oras() != null)
    .collect(Collectors.groupingBy(Client::oras));

Filtrul elimină elementele fără oraș înainte de grupare.

Repară tu

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

Codul care dă eroarea
JAVA
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);
    }
}
După reparație, programul afișează
{Cluj=2, Iasi=1, necunoscut=1}
Indiciu

În funcția de grupare, întoarce "necunoscut" când oras() este null.

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 Optional sau 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

← Toate erorile Java

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ță 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.