Kotlin中Firestore的QuerySnapshot返回全部文档还是仅变更文档？

1. QuerySnapshot的返回范围 #

QuerySnapshot每次触发回调时，默认返回当前查询条件匹配的全部文档，并非仅返回发生新增/更新/删除的变更文档，你测试中修改1条文档后value.size()仍为2就是这个特性的体现。

2. 仅获取变更文档的实现方式 #

Firestore服务端没有提供仅返回变更文档的接口，但客户端SDK已经内置了差异计算能力，你无需自行对比全量文档，直接调用QuerySnapshot的documentChanges属性即可拿到本次触发和上一次触发相比的所有变更记录。

3. getDocuments()和getDocumentChanges()的区别与适用场景 #

核心区别 #

• getDocuments()（Kotlin中对应.documents属性）：返回当前查询匹配的全量文档列表，排序规则和你查询时指定的排序逻辑一致，所有符合条件的文档无论是否变更都会包含在内。
• getDocumentChanges()（Kotlin中对应.documentChanges属性）：返回两次快照之间的差异集合，每个元素都附带变更类型（ADDED/MODIFIED/REMOVED）、文档新旧位置索引等信息，仅包含发生变更的文档。

适用场景 #

• 用.documents：数据量小、每次需要全量刷新列表的场景，逻辑简单无需处理增量更新，直接替换整个列表数据源即可。
• 用.documentChanges：数据量较大、需要优化列表刷新性能的场景，根据变更类型对列表做对应的插入、更新、删除操作，避免全量刷新导致的列表闪烁、性能损耗。

4. 示例代码的返回逻辑 #

你给出的第一段代码：

.addSnapshotListener { snapshots, e ->
    if (e != null) {
        Log.w(TAG, "listen:error", e)
        return@addSnapshotListener
    }
    for (dc in snapshots!!.documentChanges) {
        when (dc.type) {
            DocumentChange.Type.ADDED -> Log.d(TAG, "New city:${dc.document.data}")
            DocumentChange.Type.MODIFIED -> Log.d(TAG, "Modified city: ${dc.document.data}")
            DocumentChange.Type.REMOVED -> Log.d(TAG, "Removed city: ${dc.document.data}")
        }
    }
}

监听器返回的snapshots本身仍然包含全量文档，但你遍历的.documentChanges是SDK已经计算好的变更集合，无需你自行从全量文档中筛选：首次触发回调时，所有符合条件的文档都会以ADDED类型出现在集合中，后续触发时仅包含实际发生变更的文档。

针对你的测试疑问解答 #

你测试中打印的value.size()是全量文档的数量，属于正常现象。你不需要自行拿全量文档筛选变更，直接调用.documentChanges即可拿到处理好的变更内容，差异对比逻辑已经由SDK内部实现，无需手动开发。

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