...
Eroare Kotlin · Null safety

java.lang.NullPointerException: getenv(...) must not be null

Pe scurt

O funcție Java a întors null, iar tu ai pus rezultatul într-o variabilă Kotlin non-null (String). Kotlin verifică la atribuire și aruncă excepția. Declară variabila nullable (String?) și tratează null-ul, de obicei cu ?: și o valoare implicită.

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

Ce înseamnă

Funcțiile scrise în Java (System.getenv, System.getProperty, metode din Android, JDBC, biblioteci vechi) nu spun dacă pot întoarce null. Kotlin le vede ca tipuri de platformă (String!): te lasă să le pui și în String, și în String?, pe răspunderea ta.

Când alegi String, compilatorul adaugă o verificare la atribuire. Dacă Java întoarce null, verificarea aruncă NullPointerException: getenv(...) must not be null: partea dinainte de (...) e numele metodei Java care a întors null. Linia din stack trace este linia atribuirii.

Mesaje din aceeași familie: getProperty(...) must not be null, getString(...) must not be null (Android), getExtras(...) must not be null. În versiunile vechi de Kotlin excepția era IllegalStateException cu același text.

De ce apare: cauzele frecvente

1Variabilă de mediu care nu există

Greșit
KOTLIN
val mod: String = System.getenv("APP_MOD")
Corect
KOTLIN
val mod: String = System.getenv("APP_MOD") ?: "dev"

getenv întoarce null când variabila nu e setată. Cu ?: ai o valoare implicită și tipul rămâne non-null.

2Proprietate de sistem lipsă

Greșit
KOTLIN
val port: String = System.getProperty("server.port")
Corect
KOTLIN
val port: String = System.getProperty("server.port", "8080")

Multe API-uri Java au o variantă cu valoare implicită; folosește-o în loc să presupui că valoarea există.

3Rezultat Java folosit direct ca non-null

Greșit
KOTLIN
val nume: String = rs.getString("nume")
Corect
KOTLIN
val nume: String? = rs.getString("nume")
println(nume ?: "(fara nume)")

O coloană SQL NULL vine ca null din JDBC. Declară tipul nullable și tratează cazul explicit.

Repară tu

Repară eroarea, direct în pagină

Programul citește modul de lucru din variabila de mediu APP_MOD_DEMO, care nu este setată, și se oprește cu NullPointerException: getenv(...) must not be null. Repară citirea ca, în lipsa variabilei, modul să fie dev, iar programul să afișeze Mod: dev.

Codul care dă eroarea
KOTLIN
fun main() {
    val mod: String = System.getenv("APP_MOD_DEMO")
    println("Mod: $mod")
}
După reparație, programul afișează
Mod: dev
Indiciu

Folosește operatorul Elvis ?: după apelul System.getenv.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.NullPointerException: getenv(...) must not be null
  • java.lang.NullPointerException: getProperty(...) must not be null
  • java.lang.NullPointerException: getString(...) must not be null
  • java.lang.IllegalStateException: getenv("APP_MOD") must not be null

Cum o eviți pe viitor

Tratează orice valoare care vine din Java ca posibil null, mai ales configurația, datele din baze de date și API-urile Android. Declară explicit String? la granița cu Java și transformă imediat în non-null cu ?:, requireNotNull(x) { "mesaj clar" } sau o valoare implicită. Pentru configurație, citește toate valorile într-un singur loc, la pornire, cu mesaje de eroare clare.

Întrebări frecvente

Ce înseamnă String! din tooltip-ul IntelliJ?

Este un tip de platformă: Kotlin nu știe dacă valoarea Java poate fi null. Tu decizi tipul la atribuire, iar dacă alegi String și vine null, primești această excepție.

De ce merge pe calculatorul meu și pe server nu?

Pentru că pe calculatorul tău variabila de mediu sau proprietatea e setată, iar pe server lipsește. Valoarea implicită cu ?: sau un mesaj clar la pornire previn surpriza.

Erori înrudite

← Toate erorile Kotlin

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ță Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.