在Firestore查询中为Swift结构体赋值时遇闭包捕获未初始化变量错误

错误原因 #

这个报错的核心是Swift的初始化规则：类的初始化器必须在执行结束前，确保所有存储属性都完成初始化。而你调用的getDocuments()是异步方法，它的闭包会在init已经执行完毕后才触发——这时候init已经退出，但firstName等属性还没被赋值，闭包捕获未完全初始化的self就会触发这个错误。

两种可行解决方案 #

方案1：用可选类型+异步初始化方法（推荐）

把非可选属性改成可选类型，再提供一个静态异步方法负责从Firestore加载数据，避免在默认初始化器里处理异步逻辑：

class User {
    let uid: Int
    var firstName: String?
    var lastName: String?
    var age: Int?
    var funds: Double?

    // 私有初始化器，仅内部调用
    private init(uid: Int) {
        self.uid = uid
    }

    // 静态异步方法，加载用户数据并返回实例
    static func fetchUser(with uid: Int, completion: @escaping (User?, Error?) -> Void) {
        let db = Firestore.firestore()
        db.collection("users").whereField(K.User.uid, isEqualTo: uid)
            .getDocuments() { (querySnapshot, err) in
                if let err = err {
                    completion(nil, err)
                    return
                }
                
                guard querySnapshot?.documents.count == 1, let document = querySnapshot?.documents.first else {
                    completion(nil, NSError(domain: "UserError", code: 0, userInfo: [NSLocalizedDescriptionKey: "用户不存在或重复"]))
                    return
                }
                
                let data = document.data()
                let user = User(uid: uid)
                user.firstName = data[K.User.firstName] as? String
                user.lastName = data[K.User.lastName] as? String
                user.age = data[K.User.age] as? Int
                user.funds = data[K.User.funds] as? Double
                
                completion(user, nil)
            }
    }
}

使用方式：

User.fetchUser(with: 123) { user, error in
    if let error = error {
        print("加载失败：\(error)")
        return
    }
    guard let user = user else { return }
    // 处理加载完成的用户实例
}

方案2：隐式解包可选类型（谨慎使用）

如果能100%确定Firestore中存在对应用户数据，可以把属性改成隐式解包可选，先在init里赋值nil满足初始化要求，后续闭包再填充数据：

class User {
    let uid: Int
    var firstName: String!
    var lastName: String!
    var age: Int!
    var funds: Double!

    init(uid: Int) {
        self.uid = uid
        // 先给隐式解包属性赋值nil，完成初始化
        self.firstName = nil
        self.lastName = nil
        self.age = nil
        self.funds = nil
        
        let db = Firestore.firestore()
        db.collection("users").whereField(K.User.uid, isEqualTo: uid)
            .getDocuments() { (querySnapshot, err) in
                if let err = err {
                    print(err)
                    return
                }
                
                guard querySnapshot?.documents.count == 1, let document = querySnapshot?.documents.first else {
                    print("用户不存在或重复")
                    return
                }
                
                let data = document.data()
                if let firstName = data[K.User.firstName] as? String, 
                   let lastName = data[K.User.lastName] as? String, 
                   let age = data[K.User.age] as? Int, 
                   let funds = data[K.User.funds] as? Double {
                    
                    self.firstName = firstName
                    self.lastName = lastName
                    self.age = age
                    self.funds = funds
                } else {
                    print("数据格式错误")
                }
            }
    }
}

⚠️ 注意：这种方式有风险，如果闭包还没执行就访问属性，会直接触发运行时崩溃，只适合数据必然能加载完成的场景。

总结 #

优先选择方案1，它更符合Swift的安全规范，异步逻辑清晰，也能避免隐式解包带来的潜在崩溃风险。

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