Swift开发中Firestore如何仅监听后续新增文档、忽略已有文档

最优实现方案：基于时间戳的条件监听 #

你之前的实现方案存在两个明显问题：

• 额外产生一次全量集合读请求，文档数量较多时会产生不必要的成本
• 「拉取已有uid」和「开启监听」两个操作之间存在时间差，这段时间新增的文档会被存入uidsAlreadyMade数组，导致漏处理

最合理的解决思路是直接在监听的查询上加过滤条件，只匹配创建时间晚于监听启动时刻的文档，从源头上就不会拿到历史文档，也就不会触发多余的.added事件。

方式1：使用Firestore内置元数据的创建时间 #

Firestore 6.6.0+版本的SDK支持直接查询文档元数据中自带的服务端创建时间，不需要你额外加字段，实现代码如下：

func createMatchesListener(){
    let db = Firestore.firestore()
    guard let currentUid = Auth.auth().currentUser?.uid else { return }
    // 记录监听启动的当前时间
    let listenerStartDate = Date()
    matchesListener = db.collection("Matches")
        .document(currentUid)
        .collection("Matches")
        // 只查询创建时间晚于监听启动时间的文档
        .whereField(FieldPath.documentCreatedAt(), isGreaterThan: Timestamp(date: listenerStartDate))
        .addSnapshotListener({ snapshot, error in
            if let error = error{
                print(error.localizedDescription)
                return
            }
            
            snapshot?.documentChanges.forEach({ change in
                // 这里拿到的.added全是监听启动后真正新增的文档，没有历史数据
                if change.type == .added{
                    // 直接处理新增逻辑即可，不需要判断uid是否在已有数组里
                }
                if change.type == .removed{
                    // 处理删除逻辑
                }
            })
        })
}

方式2：自行维护服务端时间戳字段（兼容性更好） #

如果你使用的SDK版本较低不支持内置创建时间查询，可以在写入Matches集合的文档时，额外加一个createdAt字段，值设为服务端时间戳，避免客户端时间偏差：

// 写入新匹配文档的示例
let matchData: [String: Any] = [
    "uid": targetUserId,
    // 其他业务字段...
    "createdAt": FieldValue.serverTimestamp() // 由服务端生成时间，准确性更高
]
db.collection("Matches").document(currentUid).collection("Matches").document(targetUserId).setData(matchData)

之后监听的时候直接过滤这个字段即可，其余逻辑和方式1一致：

.whereField("createdAt", isGreaterThan: Timestamp(date: Date()))

该方案的优势非常明显：

• 没有多余的全量读请求，只产生实际新增文档的读请求，成本更低
• Firestore的查询监听是原子操作，不存在操作间隙漏数据的问题，符合条件的变更不会丢失
• 不需要本地维护uid数组，减少了内存占用和数组操作的逻辑bug风险

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