...
Eroare Java · NullPointerException și indici în afara limitelor

java.lang.NullPointerException: Cannot invoke "String.length()" because "nume" is null

Pe scurt

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.

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

Ce înseamnă

NullPointerException (NPE) apare la rulare, când folosești o referință care e null ca și cum ar fi un obiect: îi apelezi o metodă, îi citești un câmp, îi citești lungimea.

Din Java 14, mesajul spune exact ce s-a întâmplat (helpful NullPointerExceptions):

  • Cannot invoke "String.length()" = ce încercai să faci;
  • because "nume" is null = ce valoare era null. Poate fi o variabilă locală, un câmp (this.nume), un element de tablou (produse[2]) sau rezultatul unei metode (the return value of "Client.getAdresa()").

Dacă programul e compilat fără informații de depanare, în loc de numele variabilei vezi "<local1>". Sub mesaj, stiva de apeluri arată linia: at Main.main(Main.java:5).

De unde vine null: câmpuri obiect neinițializate (implicit null), tablouri de obiecte create cu new String[3], metode care întorc null când nu găsesc ceva (map.get), sau variabile setate explicit la null.

De ce apare: cauzele frecvente

1Câmp de tip obiect neinițializat

Greșit
JAVA
class Client {
    String email;
}
...
Client c = new Client();
System.out.println(c.email.toLowerCase());
Corect
JAVA
class Client {
    String email = "";
}
...
Client c = new Client();
System.out.println(c.email.toLowerCase());

Câmpurile de tip obiect primesc implicit null. Le inițializezi în declarație sau în constructor.

2Tablou de obiecte cu poziții goale

Greșit
JAVA
String[] nume = new String[3];
nume[0] = "Ana";
for (String n : nume) {
    System.out.println(n.length());
}
Corect
JAVA
String[] nume = {"Ana", "Ion", "Maria"};
for (String n : nume) {
    System.out.println(n.length());
}

new String[3] creează trei poziții null. Doar prima a primit o valoare.

3Metodă care întoarce null

Greșit
JAVA
String oras = cautaOras("Cluj");
System.out.println(oras.toUpperCase());
Corect
JAVA
String oras = cautaOras("Cluj");
if (oras != null) {
    System.out.println(oras.toUpperCase());
}

Când o metodă poate întoarce null, verifici rezultatul înainte să îl folosești (sau metoda întoarce Optional).

4equals apelat pe o valoare posibil null

Greșit
JAVA
if (status.equals("activ")) { }
Corect
JAVA
if ("activ".equals(status)) { }

Apelat pe literalul "activ", equals întoarce false pentru null în loc să arunce excepția.

Repară tu

Repară eroarea, direct în pagină

Programul afișează lungimea fiecărui nume dintr-o listă de clienți, dar se oprește cu NullPointerException, pentru că un client nu are numele completat. Repară bucla, ca pentru numele lipsă să afișeze (fara nume) și să nu se oprească.

Codul care dă eroarea
JAVA
public class Main {
    public static void main(String[] args) {
        String[] clienti = {"Ana", null, "Bogdan"};
        for (String nume : clienti) {
            System.out.println(nume + ": " + nume.length() + " litere");
        }
    }
}
După reparație, programul afișează
Ana: 3 litere
(fara nume)
Bogdan: 6 litere
Indiciu

Verifică dacă elementul e null înainte să îi apelezi length().

Alte forme ale mesajului

  • Exception in thread "main" java.lang.NullPointerException: Cannot invoke "String.length()" because "<local1>" is null
  • java.lang.NullPointerException: Cannot read field "pret" because "p" is null
  • java.lang.NullPointerException: Cannot invoke "String.toUpperCase()" because the return value of "Client.getNume()" is null
  • java.lang.NullPointerException: Cannot read the array length because "note" is null
  • java.lang.NullPointerException

Cum o eviți pe viitor

  • Inițializează câmpurile de tip obiect în declarație sau în constructor ("", new ArrayList<>()).
  • Nu întoarce null din metode când poți întoarce o listă goală sau un Optional.
  • Scrie comparațiile cu constanta în stânga: "activ".equals(status).
  • Folosește Objects.requireNonNull(param, "mesaj") la intrarea în metode, ca eroarea să apară devreme și clar.
  • Citește partea because "..." is null din mesaj: îți spune exact ce să urmărești.

Întrebări frecvente

De ce văd <local1> în loc de numele variabilei?

Codul a fost compilat fără informații de depanare (javac fără -g). Numărul indică a câta variabilă locală e. Linia din stiva de apeluri te duce oricum la locul exact.

Ar trebui să prind NullPointerException cu try/catch?

Aproape niciodată. NPE înseamnă o greșeală în cod; o repari găsind de unde vine null, nu o ascunzi.

De ce compilatorul nu m-a avertizat?

Java nu urmărește la compilare dacă o referință poate fi null. Unele editoare au analize suplimentare, dar limbajul nu le impune.

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.