如何为Firestore snapshot listener添加过滤仅监听新增文档

Firestore 原生没有提供服务端层面的配置项，可以让 snapshot listener 直接忽略修改、删除类型的变更，只返回新增文档。
你当前在客户端回调里判断 change.type == .added、手动忽略 .removed/.modified 类型变更的写法，无法避免删除操作产生的读取计费：只要监听器接收到了变更推送，不管你客户端是否处理对应逻辑，这部分数据已经从服务端传输到客户端，对应的读取次数就已经被统计计费。

可落地的优化方案（规避删除产生的额外读取） #

你遇到的双次读取问题，本质是接收端主动删除文档的操作会被监听器捕获、产生额外推送，按以下方式调整即可解决：

• 取消接收端收到消息后立即删除服务端文档的逻辑，改为给消息文档增加isReceived布尔字段，接收端处理完新消息后，将对应文档的isReceived字段更新为true
• 给集合配置 TTL（生存时间）策略，设置规则自动删除isReceived == true且留存超过指定期限（比如1天，可根据自己的业务需求设置）的历史消息：Firestore 的 TTL 后台删除是静默执行的，不会触发活跃的 snapshot listener，也不会产生额外的读取计费，删除操作本身也不产生费用
• 给监听器的查询条件增加过滤规则，只查询isReceived == false的待接收消息，配合你原本按时间排序的逻辑即可。

客户端逻辑补全参考 #

你当前的代码片段只写到了判断新增变更的入口，补全后的可运行逻辑参考如下：

firestoreListener = FirebaseManager.shared.firestore
    .collection("user_messages")
    .document(myId)
    .collection("my_messages")
    .whereField("isReceived", isEqualTo: false) // 过滤仅拉取未接收的消息
    .order(by: "timestamp")
    .addSnapshotListener { [weak self] querySnapshot, error in
        guard let self = self else { return }
        if let error = error {
            self.errorMessage = "listener failed: \(error.localizedDescription)"
            return
        }
        
        querySnapshot?.documentChanges.forEach({ change in
            // 非新增类型的变更直接跳过，不做业务处理
            guard change.type == .added else { return }
            
            // 此处写新消息解析、落本地、UI刷新的业务逻辑
            let message = change.document.data()
            
            // 消息处理完成后，标记为已接收，后续由TTL策略自动清理
            change.document.reference.updateData(["isReceived": true])
        })
    }

补充：如果不想配置TTL，也可以选择在业务低峰期（比如APP切到后台、用户退出会话页时）先移除监听器，再批量删除已处理的历史消息，这种情况下删除操作不会推送到已经失效的监听器，也不会产生额外读取。

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