基于Firestore实现无需Cloud Messaging的聊天未读消息徽章通知
纯Firestore实现聊天未读红点、未读计数的落地方案
整个方案完全基于Firestore的原生实时能力,不需要依赖Cloud Messaging,结合你现有的数据库结构做少量字段扩展即可落地。
一、现有数据结构的必要扩展
你现有的users/{userId}/chatList子集合是每个用户独立的会话列表,只需要给每个会话文档新增3个字段,不用改动原有结构:
unreadCount:数字类型,存储当前用户在对应会话下的未读消息数,默认初始值为0lastMessageTimestamp:数字类型,存储会话最近一条消息的时间戳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
相关产品推荐
相关产品推荐

