...
Eroare Kotlin · Null safety

kotlin.UninitializedPropertyAccessException: lateinit property nume has not been initialized

Pe scurt

Ai citit o proprietate lateinit var înainte să-i dai o valoare. lateinit e o promisiune că o inițializezi înainte de folosire, iar promisiunea n-a fost respectată. Atribuie valoarea mai devreme, verifică cu ::nume.isInitialized sau folosește un tip nullable ori by lazy.

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

Ce înseamnă

lateinit var nume: String îi spune compilatorului: „proprietatea n-are valoare la creare, dar i-o dau eu înainte s-o folosesc”. Compilatorul te crede și nu mai cere inițializare. Dacă o citești totuși înainte de atribuire, la rulare primești kotlin.UninitializedPropertyAccessException: lateinit property nume has not been initialized.

Stiva arată întâi getter-ul (at Client.getNume(main.kt:1)) și apoi linia din codul tău unde ai citit proprietatea. Cauzele uzuale: o metodă de configurare (init, setup, onCreate în Android) care nu s-a apelat încă, ordinea greșită a apelurilor sau un drum prin cod care sare peste atribuire.

Poți verifica înainte cu this::nume.isInitialized, dar dacă ai nevoie des de verificarea asta, probabil un tip nullable (String? = null) sau val nume by lazy { ... } se potrivește mai bine.

De ce apare: cauzele frecvente

1Metoda de configurare nu a fost apelată

Greșit
KOTLIN
class Raport {
    lateinit var titlu: String
    fun configureaza(t: String) { titlu = t }
}

fun main() {
    val r = Raport()
    println(r.titlu)
}
Corect
KOTLIN
class Raport {
    lateinit var titlu: String
    fun configureaza(t: String) { titlu = t }
}

fun main() {
    val r = Raport()
    r.configureaza("Vanzari")
    println(r.titlu)
}

Proprietatea primește valoare doar în configureaza. Apelând-o înainte de citire, promisiunea lui lateinit e respectată.

2Valoare care poate lipsi cu adevărat

Greșit
KOTLIN
class Sesiune {
    lateinit var utilizator: String
}

fun main() {
    println(Sesiune().utilizator)
}
Corect
KOTLIN
class Sesiune {
    var utilizator: String? = null
}

fun main() {
    println(Sesiune().utilizator ?: "neautentificat")
}

Dacă lipsa valorii e o stare normală (nimeni logat), String? o face explicită și compilatorul te obligă s-o tratezi.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos se oprește cu lateinit property moneda has not been initialized, pentru că prețul este afișat înainte de configurarea monedei. Repară ordinea apelurilor ca programul să afișeze Pret: 120 RON.

Codul care dă eroarea
KOTLIN
class Magazin {
    lateinit var moneda: String

    fun configureazaMoneda(m: String) {
        moneda = m
    }

    fun afiseaza(pret: Int) {
        println("Pret: $pret $moneda")
    }
}

fun main() {
    val magazin = Magazin()
    magazin.afiseaza(120)
    magazin.configureazaMoneda("RON")
}
După reparație, programul afișează
Pret: 120 RON
Indiciu

Apelează configureazaMoneda înainte de afiseaza.

Alte forme ale mesajului

  • lateinit property nume has not been initialized
  • UninitializedPropertyAccessException: lateinit property binding has not been initialized
  • kotlin.UninitializedPropertyAccessException: lateinit property adapter has not been initialized

Cum o eviți pe viitor

Folosește lateinit doar când inițializarea are loc sigur înainte de orice folosire, de exemplu în Android, în onCreate, înaintea oricărei alte metode. Dacă valoarea se poate calcula din alte date, val x by lazy { ... } o calculează automat la prima folosire. Dacă poate lipsi, folosește un tip nullable. Și ține atribuirile lateinit cât mai aproape de crearea obiectului.

Întrebări frecvente

Cum verific dacă o proprietate lateinit a fost inițializată?

Din interiorul clasei: if (this::titlu.isInitialized) { ... }. E util la curățare (de exemplu închiderea unei resurse), dar dacă îl folosești peste tot, un tip nullable e mai potrivit.

De ce apare des în Android cu binding sau adapter?

Pentru că lateinit var binding se inițializează în onCreate sau onCreateView. Dacă îl folosești dintr-un callback care rulează înainte sau după (de exemplu după onDestroyView), valoarea nu mai e acolo.

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.