Swift中使用Firestore监听器仍获取已删除文档的问题排查

你遇到的核心问题大概率是Firestore客户端本地缓存了旧数据——即使你在控制台删除了所有文档，APP依然读取缓存里的历史数据（也就是你看到的8个旧文档），而新添加的venue字段在这些旧缓存文档中不存在，自然解析后为nil。下面一步步帮你排查和解决：

一、先确认缓存问题的快速验证方法 #

• 彻底关闭APP（不是后台挂起，是完全退出后重启），再发起查询。如果返回的文档数量变成1个，那基本实锤是缓存在搞鬼。
• 打开手机飞行模式再查询，如果依然能返回8个文档，100%是读取了本地缓存。

二、针对性解决方法 #

1. 临时禁用离线缓存（仅测试用） #

如果只是想快速验证问题，可以初始化Firestore时关闭离线缓存功能：

let settings = FirestoreSettings()
settings.isPersistenceEnabled = false
Firestore.firestore().settings = settings

⚠️ 注意：这个方法不建议生产环境使用，离线缓存是Firestore提升用户体验的核心特性之一。

2. 强制从服务器获取最新数据 #

你当前用的是addSnapshotListener监听数据，可以通过开启元数据监听+判断来源的方式，确保拿到最新的云端数据：

let listener = FirestoreCollectionReference.events.reference()
    .whereField("city", isEqualTo: selectedCity)
    .whereField("eventType", isEqualTo: selectedEventType)
    .whereField("coordinate", isGreaterThan: lesserGeopoint)
    .whereField("coordinate", isLessThan: greaterGeopoint)
    .order(by: "coordinate")
    .order(by: "dateTimeStart", descending: true)
    .limit(to: 20)
    // 开启元数据变化监听，能知道数据来自缓存还是服务器
    .addSnapshotListener(includeMetadataChanges: true) { (snapshot, error) in
        if let error = error {
            completion(nil,eventListener)
            print("Error when observing events document: \(error.localizedDescription)")
            return
        }
        
        guard let documentsSnapshot = snapshot else {
            completion(nil, eventListener)
            return
        }
        
        // 打印数据来源，确认是否是服务器最新数据
        if documentsSnapshot.metadata.isFromCache {
            print("当前数据来自本地缓存")
        } else {
            print("当前数据来自云端服务器")
        }
        
        print("the number of documents: \(documentsSnapshot.documents.count)")
        var eventsArray = [EventKM]()
        for document in documentsSnapshot.documents {
            let eventDictionary = document.data()
            let theEvent = EventKM(dictionary: eventDictionary)
            eventsArray.append(theEvent)
        }
        completion(eventsArray,eventListener)
    }

当缓存和服务器数据同步完成后，会触发第二次回调，此时isFromCache会变为false，拿到的就是最新数据。

3. 彻底清理本地缓存 #

如果需要一次性清除所有缓存数据，可以调用Firestore的清理方法（建议在APP启动时或无活跃监听时调用）：

do {
    try Firestore.firestore().clearPersistence()
    print("本地缓存清理成功")
} catch {
    print("清理缓存失败: \(error.localizedDescription)")
}

4. 排查Firestore版本问题 #

你怀疑Beta版Bug的可能性确实存在，建议升级到最新稳定版：

• 在Podfile中确保使用稳定版依赖：

  pod 'Firebase/Firestore'
  

• 执行pod update Firebase/Firestore升级后再测试问题是否消失。

三、关于venue字段为nil的额外优化 #

即使解决了缓存问题，也建议在EventKM模型中给venue字段设置默认值，避免因字段缺失出现nil：

struct EventKM {
    var venue: String // 用非可选类型+默认值
    // 其他字段...
    
    init(dictionary: [String: Any]) {
        self.venue = dictionary["venue"] as? String ?? "" // 字段不存在时用空字符串替代
        // 其他字段解析逻辑...
    }
}

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