Fatal error: Unexpectedly found nil while unwrapping an Optional value
Programul s-a oprit pentru că ai despachetat cu ! un opțional care era nil (o conversie Int("abc")!, o cheie lipsă dict["x"]!, first! pe o listă goală). Înlocuiește ! cu if let, guard let sau ??, ca să tratezi cazul fără valoare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Este cea mai cunoscută eroare la rulare din Swift. Codul compilează, dar în momentul în care execuția ajunge la un x! și x este nil, programul se oprește imediat cu Fatal error: Unexpectedly found nil while unwrapping an Optional value. În Xcode vezi și Thread 1: Fatal error: ... pe linia cu problema; în consola de aici, mesajul arată și linia (main/main.swift:2).
! înseamnă „îți garantez că aici există o valoare”. Când garanția e falsă, Swift preferă să oprească programul decât să continue cu date greșite.
Sursele obișnuite: Int(text)! cu un text care nu e număr, dict["cheie"]! cu o cheie care lipsește, lista.first! sau lista.max()! pe o listă goală, firstIndex(of:)! pentru un element inexistent, și variabilele declarate Int! (implicit despachetate) folosite înainte să primească valoare: atunci mesajul spune while implicitly unwrapping an Optional value.
Reparația nu e să muți !-ul, ci să tratezi cazul nil: if let, guard let sau ??.
De ce apare: cauzele frecvente
1Conversie din text forțată cu !
let text = "12a"
let n = Int(text)!
print(n)let text = "12a"
if let n = Int(text) {
print(n)
} else {
print("Nu e număr: \(text)")
}Int("12a") e nil, iar ! oprește programul. if let tratează ambele situații.
2Cheie lipsă într-un dicționar
let stoc = ["mere": 10]
print(stoc["pere"]!)let stoc = ["mere": 10]
print(stoc["pere"] ?? 0)Pentru o cheie care nu există dicționarul întoarce nil. ?? 0 dă o valoare implicită.
3first! pe o listă care poate fi goală
let comenzi: [String] = []
print(comenzi.first!)let comenzi: [String] = []
if let prima = comenzi.first {
print(prima)
} else {
print("Nu există comenzi")
}first e nil pentru o listă goală. if let tratează explicit cazul, în loc să lase ! să oprească programul.
Repară eroarea, direct în pagină
Programul caută prețul unui produs în listă și trebuie să afișeze Preț banane: indisponibil, pentru că bananele nu sunt în listă, dar se oprește cu Fatal error: Unexpectedly found nil while unwrapping an Optional value. Înlocuiește ! cu if let ... else, fără să schimbi dicționarul.
let preturi = ["mere": 5, "pere": 7]
let produs = "banane"
let pret = preturi[produs]!
print("Preț \(produs): \(pret) lei")Preț banane: indisponibil
Indiciu
Accesul preturi["banane"] întoarce nil pentru o cheie care lipsește.
Reparația
let preturi = ["mere": 5, "pere": 7]
let produs = "banane"
if let pret = preturi[produs] {
print("Preț \(produs): \(pret) lei")
} else {
print("Preț \(produs): indisponibil")
}De ce merge
Un dicționar întoarce mereu un opțional la acces, pentru că cheia poate lipsi. Cu ! programul presupunea că banane există, iar când a găsit nil s-a oprit. if let verifică întâi: dacă există preț, îl afișează, altfel se execută ramura else. Programul tratează acum ambele cazuri și nu se mai oprește, indiferent ce produs cauți.
Alte forme ale mesajului
Fatal error: Unexpectedly found nil while implicitly unwrapping an Optional valueThread 1: Fatal error: Unexpectedly found nil while unwrapping an Optional value
Cum o eviți pe viitor
- Tratează
!ca pe un semnal de alarmă la code review: fiecare trebuie justificat. - Folosește
guard let ... else { return }la începutul funcțiilor pentru valorile obligatorii. - Pentru date care vin din afară (texte, JSON, input), nu folosi niciodată
!: ele pot fi oricând invalide. - Dacă ai nevoie de
!pentru că ești sigur, lasă un comentariu cu motivul sau foloseșteguardcu unfatalError("motiv")clar.
Întrebări frecvente
De ce codul a mers ieri și azi se oprește?
Pentru că eroarea depinde de date: cu un text valid sau o listă plină, ! găsește valoare. Când datele se schimbă (o cheie lipsă, un câmp gol), opționalul devine nil și programul se oprește.
Pot prinde eroarea cu do-catch?
Nu. O eroare fatală nu e o eroare aruncată cu throw, ci oprirea programului. Singura soluție e să nu ajungi în situația asta: verifici opționalul înainte.
Erori înrudite
error: value of optional type 'Int?' must be unwrapped to a value of type 'Int' Folosești un opțional (Int?, String?) acolo unde e nevoie de o valoare sigură. Despachetează-l întâi: if let x { ... }, guard let x else { ... }, x ?? valoareImplicita sau, doar dacă ești sigur că nu e nil, x!. error: value of optional type 'String?' must be unwrapped to refer to member 'count' of wrapped base type 'String' Accesezi o proprietate sau o metodă (count, uppercased()) pe un opțional. Folosește optional chaining (nume?.count, care dă tot un opțional), despachetează cu if let / guard let sau dă o valoare implicită cu ??. Fatal error: Index out of range Ai accesat un element de tablou cu un indice care nu există: negativ sau mai mare ori egal cu count (de exemplu lista[3] într-o listă cu 3 elemente). Indicii merg de la 0 la count - 1; verifică indicele sau folosește indices, first, last. Învață Swift de la zero, cu exerciții la fiecare lecție
Curs Swift (iOS): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
