java.lang.NullPointerException: getenv(...) must not be null
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ă
val mod: String = System.getenv("APP_MOD")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ă
val port: String = System.getProperty("server.port")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
val nume: String = rs.getString("nume")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ă 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.
fun main() {
val mod: String = System.getenv("APP_MOD_DEMO")
println("Mod: $mod")
}Mod: dev
Indiciu
Folosește operatorul Elvis ?: după apelul System.getenv.
Reparația
fun main() {
val mod: String = System.getenv("APP_MOD_DEMO") ?: "dev"
println("Mod: $mod")
}De ce merge
System.getenv este o funcție Java și întoarce null pentru o variabilă care nu există. Pentru că variabila Kotlin era declarată String, compilatorul a pus o verificare de non-null la atribuire, care a aruncat excepția. Cu ?: "dev", null-ul este înlocuit înainte de atribuire, iar mod primește o valoare validă.
Alte forme ale mesajului
Exception in thread "main" java.lang.NullPointerException: getenv(...) must not be nulljava.lang.NullPointerException: getProperty(...) must not be nulljava.lang.NullPointerException: getString(...) must not be nulljava.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
Exception in thread "main" java.lang.NullPointerException Programul a dat de null la rulare acolo unde aștepta o valoare. În Kotlin asta se întâmplă aproape mereu din cauza operatorului !! pe o valoare null (sau a unui lateinit / cod Java). Înlocuiește !! cu ?. și ?: sau verifică valoarea înainte. java.lang.NullPointerException: null cannot be cast to non-null type kotlin.String Ai făcut cast cu as String (sau alt tip non-null) pe o valoare care era null. as nu acceptă null decât dacă tipul țintă e nullable. Folosește as? String, care dă null în loc de excepție, și tratează cazul cu ?: valoare implicită. java.lang.NullPointerException: Parameter specified as non-null is null: method Formatare.apply, parameter t Cod Java (o bibliotecă, un framework, un callback Android) a apelat o funcție Kotlin cu null pentru un parametru declarat non-null. Kotlin verifică parametrii la intrare și aruncă excepția. Declară parametrul nullable (String?) și tratează null-ul. Î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.
