You need to enable JavaScript to run this app. 基于Firestore实现无需Cloud Messaging的聊天未读消息徽章通知
优惠活动
大模型
产品
解决方案
定价
更多

基于Firestore实现无需Cloud Messaging的聊天未读消息徽章通知

纯Firestore实现聊天未读红点、未读计数的落地方案

整个方案完全基于Firestore的原生实时能力,不需要依赖Cloud Messaging,结合你现有的数据库结构做少量字段扩展即可落地。

一、现有数据结构的必要扩展

你现有的users/{userId}/chatList子集合是每个用户独立的会话列表,只需要给每个会话文档新增3个字段,不用改动原有结构:

  • unreadCount:数字类型,存储当前用户在对应会话下的未读消息数,默认初始值为0
  • lastMessageTimestamp:数字类型,存储会话最近一条消息的时间戳
  • lastReadTimestamp:数字类型,存储当前用户上次查看该会话消息的时间戳

现有的chatRooms/{chatRoomId}/{messageId}消息文档结构完全可以复用,不需要额外调整。

二、核心功能实现逻辑

1. 发消息时同步更新会话未读数据

直接在你现有的sendMessage方法中,写完消息文档后,同步更新收发双方的chatList会话数据即可:

async sendMessage(content) {
  if (content.trim() === '') { return }
  
  const timestamp = moment().valueOf().toString();
  const idFrom = this.authUser.userId;
  const idTo = this.currentPeerUser.userId;
  const message = { id: timestamp, idFrom, idTo, timestamp, content };

  // 原有逻辑:写入消息文档
  const chatRoomRef = db.collection('chatRooms').doc(this.chatRoomId)
                        .collection(this.chatRoomId).doc(timestamp);
  await chatRoomRef.set(message);

  // 新增逻辑:更新发送方自己的会话信息
  const senderChatListRef = db.collection('users').doc(idFrom).collection('chatList').doc(this.chatRoomId);
  await senderChatListRef.set({
    lastMessageTimestamp: timestamp
  }, { merge: true });

  // 新增逻辑:给接收方原子累加未读计数
  const receiverChatListRef = db.collection('users').doc(idTo).collection('chatList').doc(this.chatRoomId);
  await receiverChatListRef.set({
    lastMessageTimestamp: timestamp,
    unreadCount: firebase.firestore.FieldValue.increment(1)
  }, { merge: true });

  this.inputValue = '';
}

注:用FieldValue.increment(1)做原子累加,能避免并发写导致的未读计数错乱,merge: true参数不会覆盖文档里已有的其他字段。

2. 实时同步未读状态,渲染红点和计数

用户登录应用后,对当前用户的整个chatList子集合挂实时监听器,只要应用处于存活状态,未读数据的变化会实时推送到客户端,完全不需要额外的推送服务:

// 用户登录后执行一次全局监听
const currentUserId = this.authUser.userId;
const userChatListRef = db.collection('users').doc(currentUserId).collection('chatList');
userChatListRef.onSnapshot((snapshot) => {
  let totalUnread = 0;
  const sessionUnreadMap = {};
  snapshot.forEach(doc => {
    const sessionData = doc.data();
    const currentUnread = sessionData.unreadCount || 0;
    totalUnread += currentUnread;
    sessionUnreadMap[doc.id] = currentUnread;
  });

  // 把上述数据直接绑定到UI状态:
  // - 全局聊天入口图标:totalUnread > 0 显示红点,数值大于1时直接展示具体未读总数
  // - 会话列表项:对应会话的unread值大于0时,在会话右侧显示红点或具体数字
})

可加优化逻辑:在监听器内增加状态判断,如果用户当前正处在某个聊天会话页面,收到该会话的新消息时,直接把该会话的unreadCount重置为0,避免出现用户正在聊天时未读数字仍持续上涨的问题。

3. 进入会话时重置未读计数

当用户主动点开某个聊天会话,加载消息的同时,直接把当前用户在该会话下的未读计数清零,同步更新上次阅读的时间戳即可:

// 进入会话时执行
await db.collection('users').doc(currentUserId).collection('chatList').doc(this.chatRoomId).set({
  unreadCount: 0,
  lastReadTimestamp: moment().valueOf().toString()
}, { merge: true });

三、配套注意事项

  • 这个方案完全满足应用内功能图标显示红点、未读总数统计的需求,只要应用打开(无论前台还是后台存活),实时监听都能拿到准确的未读数据;如果需要应用被系统杀死后还能弹出系统级通知,才需要用到Cloud Messaging,纯靠Firestore的监听能力无法实现被杀死应用的主动推送。
  • 记得给Firestore安全规则配置权限限制,只允许用户读写自己的chatList子集合数据,防止跨用户篡改未读计数,参考规则:
    match /users/{userId}/chatList/{sessionId} {
      allow read, write: if request.auth.uid == userId;
    }
    
  • 全程不需要遍历会话下的所有消息计算未读数,所有计数都存在用户自己的chatList文档里,能大幅降低Firestore的资源读取消耗。

内容的提问来源于stack exchange,提问作者Alex

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 13:36:07