Swift中用Codable映射Firestore文档的作用域与self错误排查

错误1：Cannot find fetchUser in scope #

问题原因 #

fetchUser方法定义在FetchUserVM类中，ProfileViewModel直接调用时未进入该方法的作用域——要么没有实例化FetchUserVM，要么原FetchUserVM的fetchUser不支持传入uid和回调参数。

解决步骤 #

1. 修改FetchUserVM，新增支持uid和回调的单用户获取方法：

class FetchUserVM: ObservableObject {
    @Published var user = [UserModel]()
    private var db = Firestore.firestore()

    // 保留原批量获取方法
    func fetchUser() {
        db.collection("Users").addSnapshotListener { (querySnapshot, error) in
            guard let documents = querySnapshot?.documents else {
                print("No Documents")
                return
            }
            self.user = documents.compactMap { try? $0.data(as: UserModel.self) }
        }
    }

    // 新增单用户获取方法
    func fetchUser(uid: String, completion: @escaping (UserModel?) -> Void) {
        db.collection("Users").document(uid).getDocument { document, error in
            guard let document = document, document.exists else {
                completion(nil)
                return
            }
            do {
                let user = try document.data(as: UserModel.self)
                completion(user)
            } catch {
                print(error)
                completion(nil)
            }
        }
    }
}

2. 在ProfileViewModel中实例化FetchUserVM并调用方法：

class ProfileViewModel : ObservableObject {
    @Published var userInfo: UserModel?
    private let fetchUserVM = FetchUserVM()
    private let uid: String // 确保uid已正确初始化

    init(uid: String) {
        self.uid = uid
        fetchUserVM.fetchUser(uid: uid) { [weak self] user in
            self?.userInfo = user
        }
    }
}

错误2：Cannot find self in scope #

问题原因 #

修改后的fetchUser是全局函数，而self仅能在类/结构体的实例方法中使用——全局函数没有所属实例，无法访问self。

解决步骤 #

将fetchUser移到对应类（如ProfileViewModel）中作为实例方法，同时在闭包中使用弱引用避免循环引用：

class ProfileViewModel : ObservableObject {
    @Published var user: UserModel?
    @Published var errorMessage = ""
    private let uid: String

    init(uid: String) {
        self.uid = uid
        fetchUser(documentId: uid)
    }

    // 作为类的实例方法实现
    func fetchUser(documentId: String) {
        let db = Firestore.firestore()
        let docRef = db.collection("Users").document(documentId)

        docRef.getDocument { [weak self] document, error in
            guard let self = self else { return }
            
            if let error = error as NSError? {
                self.errorMessage = "Error getting document: \(error.localizedDescription)"
            } else if let document = document, document.exists {
                do {
                    self.user = try document.data(as: UserModel.self)
                } catch {
                    print(error)
                }
            }
        }
    }
}

额外注意事项 #

• 确保UserModel遵循Codable协议，字段名与Firestore文档一致，或通过CodingKeys自定义映射：

struct UserModel: Codable, Identifiable {
    let id: String
    let name: String
    let email: String

    // 若Firestore字段名不同，添加映射
    enum CodingKeys: String, CodingKey {
        case id = "user_id"
        case name
        case email
    }
}

• 闭包中使用[weak self]避免循环引用，防止内存泄漏
• 确认Firestore安全规则允许读取Users集合的文档

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