克隆Firebase图表项目后遇可选值解包nil错误求助

克隆可正常运行的Firebase图表应用到个人项目后，持续出现「Thread 1: Fatal error: Unexpectedly found nil while unwrapping an Optional value」错误，关联的User类代码如下：

import UIKit

class User: NSObject {
    @objc var name: String?
    @objc var email: String?
    @objc var januaryE: NSNumber?
    @objc var febrauryE: NSNumber?
    @objc var marchE: NSNumber?
    @objc var aprilE: NSNumber?
    @objc var mayE: NSNumber?
    @objc var juneE: NSNumber?
    @objc var julyE: NSNumber?
    @objc var augustE: NSNumber?
    @objc var septemberE: NSNumber?
    @objc var octoberE: NSNumber?
    @objc var novemberE: NSNumber?
    @objc var decemberE: NSNumber?
    @objc var januaryS: NSNumber?
    @objc var febrauryS: NSNumber?
    @objc var marchS: NSNumber?
    @objc var aprilS: NSNumber?
    @objc var mayS: NSNumber?
    @objc var juneS: NSNumber?
    @objc var julyS: NSNumber?
    @objc var augustS: NSNumber?
    @objc var septemberS: NSNumber?
    @objc var octoberS: NSNumber?
    @objc var novemberS: NSNumber?
    @objc var decemberS: NSNumber?
    
    init(dictionary: [String: Any]) {
        self.name = dictionary["text"] as? String
        self.email = dictionary["email"] as? String
        self.januaryE = dictionary["januaryE"] as? NSNumber
        self.febrauryE = dictionary["febrauryE"] as? NSNumber
        self.marchE = dictionary["marchE"] as? NSNumber
        self.aprilE = dictionary["aprilE"] as? NSNumber
        self.mayE = dictionary["mayE"] as? NSNumber
        self.juneE = dictionary["juneE"] as? NSNumber
        self.julyE = dictionary["julyE"] as? NSNumber
        self.augustE = dictionary["augustE"] as? NSNumber
        self.septemberE = dictionary["septemberE"] as? NSNumber
        self.octoberE = dictionary["octoberE"] as? NSNumber
        self.novemberE = dictionary["novemberE"] as? NSNumber
        self.decemberE = dictionary["decemberE"] as? NSNumber
        self.januaryS = dictionary["januaryS"] as? NSNumber
        self.febrauryS = dictionary["febrauryS"] as? NSNumber
        self.marchS = dictionary["marchS"] as? NSNumber
        self.aprilS = dictionary["aprilS"] as? NSNumber
        self.mayS = dictionary["mayS"] as? NSNumber
        self.juneS = dictionary["juneS"] as? NSNumber
        self.julyS = dictionary["julyS"] as? NSNumber
        self.augustS = dictionary["augustS"] as? NSNumber
        self.septemberS = dictionary["septemberS"] as? NSNumber
        self.octoberS = dictionary["octoberS"] as? NSNumber
        self.novemberS = dictionary["novemberS"] as? NSNumber
        self.decemberS = dictionary["decemberS"] as? NSNumber
    }
}

问题分析 #

User类的所有属性均为可选类型，初始化时使用as?安全转换，因此崩溃点不在初始化方法内部，而是在其他代码中对这些可选属性进行了强制解包（如!或隐式解包）。常见诱因包括：

• Firebase数据库字段名与代码不匹配：比如代码中用dictionary["text"]给name赋值，但你的Firebase数据中名字字段是name，导致name为nil，后续解包崩溃。
• 数据类型不匹配：比如Firebase中数字字段存为String类型，代码中转为NSNumber失败，属性为nil后被强制解包。
• 数据库缺少部分字段：原项目数据完整，你的项目中某条用户数据缺失某个月份的E/S字段，导致对应属性为nil，后续解包出错。
• 代码拼写错误：注意到类中febraury是拼写错误（正确应为february），若原项目使用正确拼写，你的数据字段名也需同步，否则对应属性会为nil。

排查与解决步骤 #

1. 定位崩溃代码行
   崩溃时查看Xcode调用栈，找到具体哪一行在强制解包nil值（比如user.name!、user.januaryE!这类代码）。

2. 校验Firebase数据结构
   对比原项目的Firebase数据：

   • 确认所有字段名完全一致，包括大小写和拼写。
   • 确认数字字段类型为Number，而非String。

3. 替换强制解包为安全处理
   所有使用User属性的地方，避免用!强制解包，改用：

   • 可选绑定：

     if let userName = user.name {
         // 使用userName
     } else {
         // 处理name为nil的情况
     }
     

   • 空合并运算符：

     let displayName = user.name ?? "匿名用户"
     let januaryEarning = user.januaryE?.doubleValue ?? 0.0
     

4. 优化User类初始化（可选）
   给属性设置默认值，减少后续nil处理成本：

   init(dictionary: [String: Any]) {
       self.name = dictionary["text"] as? String ?? ""
       self.email = dictionary["email"] as? String ?? ""
       self.januaryE = dictionary["januaryE"] as? NSNumber ?? 0
       // 其他字段同理设置默认值
   }
   

   或改用Codable协议实现自动解析，更简洁安全：

   class User: NSObject, Codable {
       var name: String?
       var email: String?
       var januaryE: NSNumber?
       // 其他字段...
       
       enum CodingKeys: String, CodingKey {
           case name = "text"
           case email
           case januaryE, febrauryE, marchE // 其他字段...
       }
   }
   // 解析时使用JSONDecoder
   if let userData = try? JSONSerialization.data(withJSONObject: dictionary),
      let user = try? JSONDecoder().decode(User.self, from: userData) {
       // 使用user
   }
   

内容的提问来源于stack exchange，提问作者張小小