Firebase Firestore使用StreamBuilder更新Timestamp字段触发两次回调问题

• Firestore SDK 默认开启本地持久化缓存，执行写操作时会优先更新本地缓存，立即触发一次快照回调，这是第一次触发StreamBuilder的原因。
• FieldValue.serverTimestamp()是由Firebase服务器侧生成的时间值，客户端本地无法提前知晓准确值。第一次回调返回的本地快照中，普通字段已经按写入值更新，但时间戳字段处于待填充状态；待服务器写入完成、将包含真实时间戳的同步结果返回客户端后，会触发第二次快照回调，这就是两次打印HELLO的根本原因。
• 仅更新普通字段时，本地缓存的写入结果和服务器返回的最终结果完全一致，Firestore SDK 会做去重处理，因此只会触发一次回调，符合预期。

根据业务场景可以选择以下任意一种方案：

方案1：过滤本地待提交状态的快照（最常用） #

利用快照元数据的hasPendingWrites属性，跳过还未完成服务器同步的本地快照，仅处理服务器返回的最终状态数据，即可避免重复触发：

StreamBuilder(
  stream: FirebaseFirestore.instance.collection('collection').doc('ABC').snapshots(),
  builder: (_context, snapshot) {
    if (!snapshot.hasData) return const CircularProgressIndicator();
    // 跳过本地待同步的临时快照
    if (snapshot.data!.metadata.hasPendingWrites) {
      // 可根据需求返回上一次的渲染结果/加载占位
      return const SizedBox.shrink();
    }
    print('HELLO');
    return Container();
  }
)

方案2：为服务端时间戳设置本地估算值 #

如果业务允许使用近似时间戳，可以在读取字段时指定服务端时间戳的本地行为，让第一次回调时就返回客户端估算的时间值，避免字段空值：

// 读取时间戳字段时添加参数
Timestamp? createTime = snapshot.data?.get(
  'create_time', 
  {serverTimestampBehavior: ServerTimestampBehavior.estimate}
);

注意：该方案下StreamBuilder仍会触发两次，只是时间戳字段不会出现空值，适合对时间精度要求不高的场景。

方案3：关闭本地持久化（不推荐） #

初始化Firestore时关闭本地持久化缓存，所有快照都直接从服务器获取，仅会触发一次回调，但会丢失离线可用能力、加载速度变慢，仅适合纯在线场景使用：

// 初始化Firebase时配置
FirebaseFirestore.instance.settings = const Settings(
  persistenceEnabled: false,
);

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