You need to enable JavaScript to run this app. Flutter/Firebase 聊天应用如何实现图标未读消息角标数的累计管理
优惠活动
大模型
产品
解决方案
定价
更多

Flutter/Firebase 聊天应用如何实现图标未读消息角标数的累计管理

Flutter/Firebase 应用图标未读角标实现方案

当前硬编码badge: '1'的推送逻辑存在本质缺陷:移动操作系统会直接把推送请求里携带的badge值作为图标的角标数字,每次收到新推送时就会用这个新值覆盖之前显示的角标,自然无法实现累计递增的效果。

不要在每次触发推送时临时扫描全量未读消息做count统计,这种方式会产生大量Firestore读请求,随着消息量增长会带来不必要的成本和推送延迟,最稳妥的方案是建立单一可信的未读计数数据源:

  • 在每个用户的独立主文档下新增totalUnreadCount字段,专门存储该用户跨所有聊天会话的未读消息总数
  • 所有和未读状态相关的操作,都通过Firestore的原子增量操作同步更新这个字段,完全避免并发场景下的计数偏差:
    1. 新消息创建且发送对象为其他用户时,给收件人的totalUnreadCount执行+1的原子操作
    2. 用户打开某一聊天会话并将会话内所有未读消息标记为已读时,按该会话内被标记的未读消息数,给totalUnreadCount执行对应数值的-1原子扣减
    3. 当用户清空所有未读消息时,直接将totalUnreadCount重置为0

基于上面的计数逻辑,直接对现有触发推送的云函数做改造,去掉硬编码的badge值,直接读取实时维护的totalUnreadCount作为推送的角标参数:

const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp();

exports.onCreateMessage = functions.firestore.document('/Chat/{currentUserID}/UserList/{anotherUserID}/Messages/{messageID}')
    .onCreate(async (snap, context) => {
        const recieverUserID = snap.data().recieverID;
        // 仅处理发给其他用户的消息,不统计自发自收的内容
        if (recieverUserID === context.params.currentUserID) {
            const userRef = admin.firestore().doc(`/User/${recieverUserID}`);
            // 原子更新用户的全局未读总数,不会出现并发计数冲突
            await userRef.update({
                totalUnreadCount: admin.firestore.FieldValue.increment(1)
            });
            // 读取更新后的最新未读值
            const userDoc = await userRef.get();
            const latestUnreadCount = userDoc.data().totalUnreadCount || 1;

            // 发送带正确角标的推送通知
            return admin.messaging().sendToTopic(`${recieverUserID}`, {
                notification: {
                    title: snap.data().senderID,
                    body: snap.data().message,
                    clickAction: 'FLUTTER_NOTIFICATION_CLICK',
                    sound: 'default',
                    badge: latestUnreadCount.toString()
                }
            });
        }
    });

边界场景注意事项

  • 系统端的角标显示会被推送携带的badge值强制覆盖,因此角标值的来源要完全以Firestore中维护的totalUnreadCount为唯一标准,不要在本地端单独计算角标值,避免前后台切换时出现计数不一致
  • iOS系统中如果推送携带的badge值为0,会自动清除应用图标的角标,刚好适配用户清空所有未读消息的场景
  • 当应用处于前台运行状态时,需要同步调用本地的角标设置接口,将本地显示的角标值和totalUnreadCount保持一致,避免用户在APP内读了消息,但是图标上的角标还保留旧值的问题

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.18 13:15:03