...
Eroare Kotlin · Null safety

Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type 'String?'

Pe scurt

Apelezi o funcție sau o proprietate (de exemplu .length) pe o variabilă care poate fi null (tip String?). Kotlin te obligă să tratezi cazul null: folosește s?.length, s?.length ?: 0, un if (s != null), sau !! doar dacă ești sigur că nu e null.

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

Ce înseamnă

Tipul String? (cu semnul întrebării) înseamnă „un String sau null”. Când scrii s.length, Kotlin nu știe ce să facă dacă s este null, așa că refuză apelul la compilare. Asta e null safety: eroarea pe care în Java o primeai la rulare (NullPointerException) o primești aici înainte să rulezi.

Mesajul îți dă exact variantele permise:

  • s?.length (safe call): dacă s e null, rezultatul e null, fără excepție;
  • s?.length ?: 0 (Elvis): o valoare implicită pentru cazul null;
  • if (s != null) s.length: după verificare, compilatorul face smart cast la String;
  • s!!.length: „știu sigur că nu e null”; dacă greșești, primești NullPointerException la rulare.

Funcții ca toIntOrNull(), firstOrNull(), map[cheie], find {} întorc tipuri nullable, de aceea eroarea apare des după ele.

De ce apare: cauzele frecvente

1Proprietate citită direct pe un nullable

Greșit
KOTLIN
fun main() {
    val nume: String? = null
    println(nume.length)
}
Corect
KOTLIN
fun main() {
    val nume: String? = null
    println(nume?.length ?: 0)
}

?. oprește lanțul dacă valoarea e null, iar ?: dă 0 în acel caz.

2Rezultatul lui map[cheie] folosit direct

Greșit
KOTLIN
fun main() {
    val stoc = mapOf("mere" to 10)
    println(stoc["mere"].plus(5))
}
Corect
KOTLIN
fun main() {
    val stoc = mapOf("mere" to 10)
    println((stoc["mere"] ?: 0) + 5)
}

map[cheie] întoarce Int?, pentru că cheia poate lipsi. Alegi explicit ce se întâmplă atunci.

3Rezultatul lui find sau firstOrNull

Greșit
KOTLIN
fun main() {
    val produse = listOf("lapte", "paine")
    val gasit = produse.find { it.startsWith("p") }
    println(gasit.uppercase())
}
Corect
KOTLIN
fun main() {
    val produse = listOf("lapte", "paine")
    val gasit = produse.find { it.startsWith("p") }
    println(gasit?.uppercase() ?: "negasit")
}

find întoarce null dacă nu găsește nimic, deci tipul e String?.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos afișează lungimea poreclei unui utilizator, dar dă eroarea Only safe (?.) or non-null asserted (!!.) calls are allowed, pentru că porecla poate lipsi. Repară-l ca, atunci când porecla lipsește, să afișeze 0: Lungime porecla: 0.

Codul care dă eroarea
KOTLIN
fun main() {
    val porecla: String? = null
    val lungime = porecla.length
    println("Lungime porecla: $lungime")
}
După reparație, programul afișează
Lungime porecla: 0
Indiciu

Folosește apelul sigur ?. și operatorul Elvis ?: cu valoarea 0.

Alte forme ale mesajului

  • Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type String?
  • error: only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type 'String?'.
  • Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type 'Int?'

Cum o eviți pe viitor

Evită tipurile nullable unde nu ai nevoie de ele: dacă o valoare există mereu, declar-o String, nu String?. Când o valoare poate lipsi, tratează lipsa o singură dată, cât mai devreme, de exemplu val nume = input ?: "anonim", iar de acolo înainte lucrezi cu un tip non-null. Folosește !! doar în cazuri rare, unde lipsa valorii ar fi oricum o greșeală de program.

Întrebări frecvente

Ce e mai bine: ?. sau !!?

Aproape mereu ?. cu ?:, pentru că tratezi cazul null explicit. !! mută problema la rulare: dacă valoarea e null, programul se oprește cu NullPointerException.

Am verificat cu if (x != null) și tot primesc eroarea. De ce?

Smart cast-ul merge doar pe valori care nu se pot schimba între verificare și folosire: variabile locale val sau var nemodificate, proprietăți val din același modul. Pentru o proprietate var dintr-o clasă primești Smart cast is impossible: copiază valoarea într-un val local sau folosește ?.let { }.

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.