迁移Firebase Realtime Database至Firestore时无法转换快照为Photo1对象

我来帮你梳理下问题所在，以及对应的解决方案：

核心问题分析 #

1. 最初的转换失败：你的Photo1初始化方法尝试把DocumentSnapshot.data()直接转成[String:String]，但Firestore返回的字段类型可能不全是String（比如如果date字段存的是Timestamp而非字符串，或者某个字段是数字类型），这会导致photoData为nil，最终初始化返回nil。
2. 修改后的类型错误：你改成传入documentData（类型是[String : Any]），但Photo1的初始化方法期望的参数是DocumentSnapshot，类型不匹配，所以编译器抛出Cannot convert value of type '[String : Any]' to expected argument type 'DocumentSnapshot'的错误。

解决方案一：修复基于DocumentSnapshot的初始化方法 #

调整Photo1的初始化逻辑，放宽数据类型的转换限制，逐个字段解析而非直接强转成[String:String]：

class Photo1: Object {
    @objc dynamic var photoId:String?
    @objc dynamic var byId:String?
    @objc dynamic var byUsername:String?
    @objc dynamic var date:String?
    @objc dynamic var url:String?
    @objc dynamic var postId:String?
    
    override static func primaryKey() -> String? {
        return "photoId"
    }
    
    override static func indexedProperties() -> [String] {
        return ["byUsername"]
    }
    
    convenience init?(snapshot: DocumentSnapshot){
        self.init()
        // 先确保快照有数据
        guard let photoData = snapshot.data() else { return nil }
        
        let photoId = snapshot.documentID
        // 逐个字段转换为String类型，处理可能的类型差异
        let byId = photoData["byId"] as? String
        let byUsername = photoData["byUsername"] as? String
        // 如果date是Firestore Timestamp类型，需要先转成Date再转String
        let date: String?
        if let timestamp = photoData["date"] as? Timestamp {
            date = timestamp.dateValue().description
        } else {
            date = photoData["date"] as? String
        }
        let url = photoData["url"] as? String
        let postId = photoData["postId"] as? String
        
        guard byId != nil, byUsername != nil, date != nil, url != nil, postId != nil else {
            return nil
        }
        
        self.photoId = photoId
        self.byId = byId
        self.byUsername = byUsername
        self.date = date
        self.url = url
        self.postId = postId
    }
}

然后恢复你最初的getPhotos1方法即可：

static func getPhotos1(completion: @escaping ([Photo1]) -> Void) {
    let db = Firestore.firestore()
    db.collection("posts").getDocuments() { snapshot, error in
        var retrievedPhotos = [Photo1]()
        
        if let error = error {
            print("获取文档失败: \(error)")
            completion(retrievedPhotos)
            return
        }
        
        guard let documents = snapshot?.documents else {
            completion(retrievedPhotos)
            return
        }
        
        for document in documents {
            if let p = Photo1(snapshot: document) {
                retrievedPhotos.insert(p, at: 0)
            } else {
                print("解析文档失败: \(document.documentID)")
            }
        }
        
        completion(retrievedPhotos)
    }
}

解决方案二：新增基于数据字典的初始化方法 #

如果你更倾向于传入document.data()，可以给Photo1新增一个接受数据字典和文档ID的初始化方法：

class Photo1: Object {
    // ... 保留原有属性和方法
    
    convenience init?(data: [String:Any], documentID: String){
        self.init()
        
        let byId = data["byId"] as? String
        let byUsername = data["byUsername"] as? String
        let date: String?
        if let timestamp = data["date"] as? Timestamp {
            date = timestamp.dateValue().description
        } else {
            date = data["date"] as? String
        }
        let url = data["url"] as? String
        let postId = data["postId"] as? String
        
        guard byId != nil, byUsername != nil, date != nil, url != nil, postId != nil else {
            return nil
        }
        
        self.photoId = documentID
        self.byId = byId
        self.byUsername = byUsername
        self.date = date
        self.url = url
        self.postId = postId
    }
}

然后修改getPhotos1里的调用逻辑：

static func getPhotos1(completion: @escaping ([Photo1]) -> Void) {
    let db = Firestore.firestore()
    db.collection("posts").getDocuments() { (snapshot, error) in
        var retrievedPhotos = [Photo1]()
        
        if let error = error {
            print("获取文档失败: \(error)")
            completion(retrievedPhotos)
            return
        }
        
        guard let documents = snapshot?.documents else {
            completion(retrievedPhotos)
            return
        }
        
        for document in documents {
            let documentData = document.data()
            if let p = Photo1(data: documentData, documentID: document.documentID) {
                retrievedPhotos.insert(p, at: 0)
            } else {
                print("解析文档失败: \(document.documentID)")
            }
        }
        
        completion(retrievedPhotos)
    }
}

关键注意点 #

• Firestore的字段类型要和你解析的类型匹配，如果存的是Timestamp就不要直接转成String，要先转成Date再处理；
• 初始化方法里的guard语句确保所有必填字段都存在，避免创建不完整的对象；
• 建议在出错时打印日志，方便排查哪些文档解析失败。

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