Swift中如何将Firestore快照数据转为自定义UserProfileModel对象

核心错误：调用对象错误 #

你当前代码里，snapshot?.data()返回的是[AnyHashable: Any]?类型的字典，而data(as:)是**DocumentSnapshot类的专属实例方法**，字典并没有这个方法，直接调用必然失败，导致user为nil。

修正代码 #

直接使用原始的DocumentSnapshot对象执行解码操作，无需先提取字典：

import Firebase
import FirebaseFirestoreSwift

struct UserProfileModel: Identifiable, Decodable {
    @DocumentID var id: String?
    let username: String
    let fullname: String
    let profileImageUrl: String
    let email: String
}

struct UserService {
    func fetchUser(withUid uid: String) {
        print("DEBUG: Fetch user info")
        Firestore.firestore().collection("users").document(uid).getDocument { documentSnapshot, error in
            // 优先处理请求错误
            if let error = error {
                print("获取文档失败：\(error.localizedDescription)")
                return
            }
            
            // 直接用DocumentSnapshot解码模型
            guard let user = try? documentSnapshot?.data(as: UserProfileModel.self) else {
                print("解析用户模型失败")
                return
            }
            
            print("DEBUG: Username is \(user.username)")
            print("DEBUG: Email is \(user.email)")
        }
    }
}

额外排查点（若修正后仍失败） #

• 字段名严格匹配：确保Firestore中users文档的字段名和结构体属性名完全一致（区分大小写），比如结构体的profileImageUrl，Firestore里不能写成profile_image_url或ProfileImageUrl。
• 非空字段校验：结构体中所有let属性都是非可选类型，必须保证Firestore文档内这些字段都存在且不为空。若部分字段可能缺失，将对应属性改为可选类型（如let username: String?）。
• 捕获具体解码错误：将try?替换为do-catch，获取详细错误信息定位问题：

do {
    guard let user = try documentSnapshot?.data(as: UserProfileModel.self) else {
        print("文档为空或无法解析")
        return
    }
    // 处理用户数据
} catch {
    print("解码错误详情：\(error)")
}

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