...
Eroare Swift · Opționale și nil

Fatal error: Unexpectedly found nil while unwrapping an Optional value

Pe scurt

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 !

Greșit
SWIFT
let text = "12a"
let n = Int(text)!
print(n)
Corect
SWIFT
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

Greșit
SWIFT
let stoc = ["mere": 10]
print(stoc["pere"]!)
Corect
SWIFT
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ă

Greșit
SWIFT
let comenzi: [String] = []
print(comenzi.first!)
Corect
SWIFT
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ă tu

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.

Codul care dă eroarea
SWIFT
let preturi = ["mere": 5, "pere": 7]
let produs = "banane"
let pret = preturi[produs]!
print("Preț \(produs): \(pret) lei")
După reparație, programul afișează
Preț banane: indisponibil
Indiciu

Accesul preturi["banane"] întoarce nil pentru o cheie care lipsește.

Alte forme ale mesajului

  • Fatal error: Unexpectedly found nil while implicitly unwrapping an Optional value
  • Thread 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ște guard cu un fatalError("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

← Toate erorile Swift

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ță 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.