如何在Flutter Firestore聊天应用中判断消息是否已送达并实现「消息未送达」标识

嘿，这个场景太常见了！我在做聊天应用的时候也碰到过一模一样的需求，Firestore其实已经给我们准备了现成的判断方式，完全能实现类似WhatsApp的未送达提示功能。

核心判断标识：DocumentSnapshot.metadata.hasPendingWrites #

Firestore的每个DocumentSnapshot对象都带有metadata属性，其中的hasPendingWrites就是你要找的关键标识：

• 当你离线发送消息时，Firestore会先把消息写入本地缓存，这时候生成的快照的hasPendingWrites值为true——代表这条写入还在等待同步到服务器，也就是「未送达」状态。
• 当网络恢复，Firestore完成和服务器的同步后，快照会自动更新，此时hasPendingWrites会变成false——说明消息已经成功送达服务器。

结合你的场景实现 #

针对你说的「用户离线发消息，关闭再打开还是离线」的情况，Firestore的本地缓存是持久化的，所以再次打开应用读取缓存中的消息时，hasPendingWrites依然会保持true，你可以直接用这个值来触发UI上的未送达提示（比如灰色感叹号图标）。

给你一个简单的代码示例（以JavaScript为例）：

// 监听单条消息的快照变更
db.collection('chatrooms').doc(roomId).collection('messages').doc(messageId)
  .onSnapshot((snapshot) => {
    // 判断消息是否已送达服务器
    const isDelivered = !snapshot.metadata.hasPendingWrites;
    
    // 更新UI：比如显示已送达对勾，或者未送达感叹号
    if (isDelivered) {
      showDeliveredIcon(messageId);
    } else {
      showPendingIcon(messageId);
    }
  });

额外注意事项 #

• 这个属性不仅适用于离线场景，在线时如果网络延迟导致写入还未同步到服务器，hasPendingWrites也会暂时为true，能帮你实现「正在发送」的状态提示。
• 确保你使用的是Firestore默认的写入方式（不需要额外配置），因为默认的set()/add()方法都会先写本地缓存，再异步同步服务器，这样hasPendingWrites才能正确工作。
• 如果用户一次性发送多条离线消息，每条消息的快照都可以单独判断hasPendingWrites，能精准地为每条消息显示对应的状态。

这样就能完美实现你想要的功能啦，完全不需要自己额外维护状态，Firestore已经帮我们处理好了同步逻辑~

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