plus.runtime.setBadgeNumber(-1)无效,清零需分平台处理:iOS须APNs同步badge=0且在onShow执行;安卓需按厂商调用原生API;鸿蒙Next须UTS桥接系统接口。

直接调用 plus.runtime.setBadgeNumber(-1) 是最常见但错误的做法——它在绝大多数安卓机型上无效,iOS 上也不起作用。
为什么 plus.runtime.setBadgeNumber(0) 在 iOS 上有时不生效
iOS 的角标清零必须配合 APNs 通知的 badge 字段同步归零,仅客户端调用 applicationIconBadgeNumber = 0(即 H5+ 封装的 plus.runtime.setBadgeNumber(0))只影响本地状态。若上次推送服务端仍记录 badge=5,下次推送到达时系统会再次叠加或还原。
- 真机测试中,
plus.runtime.setBadgeNumber(0)必须在onShow生命周期里执行,且需确保 App 已完成 UIApplication 初始化 - 若使用极光推送,服务端推送时未设置
badge: 0,客户端清零后,下一条带badge: "+1"的消息仍会让图标显示为 1 - 鸿蒙 Next 环境下
plus对象已彻底移除,该调用直接抛出ReferenceError: plus is not defined
安卓厂商通道清零必须走对应 SDK API
安卓没有统一角标标准,plus.runtime.setBadgeNumber 只是 H5+ 引擎对各厂商私有接口的弱封装,实际成功率低于 20%。清零动作必须按机型分发:
- 华为:调用
HmsPush.setBadgeNumber(0),前提是已在 AppGallery Connect 开启「角标管理」开关,且应用拥有android.permission.CHANGE_BADGE - 小米:发送广播
android.intent.action.APPLICATION_MESSAGE_UPDATE,extra 含android.intent.extra.BADGE_COUNT= 0;仅 MIUI 12+ 且用户开启「桌面图标角标」时有效 - vivo/OPPO:几乎不响应本地调用,必须依赖 JPush 推送时携带
badge: 0字段,或使用 UTS 插件如@/uni_modules/hans-badge-setter内部反射调用 - 未接入任何推送 SDK 的纯本地方案,基本无法稳定清零 —— 这不是代码问题,是 Android 系统设计限制
推荐清零时机与兜底组合写法
不要只依赖一次调用。真实场景中,角标数字由「服务端推送逻辑 + 客户端状态同步 + 用户行为反馈」三方共同维护,清零动作需多点触发:
- App 从后台切到前台(
onShow)时,先调用plus.push.clear()清空未读通知缓存,再调用plus.runtime.setBadgeNumber(0)(iOS 有效,安卓部分机型响应) - 用户点击某条通知进入页面后,在成功标记已读的回调里,主动调用推送 SDK 的清零方法(如
JPush.setBadge(0)或HmsPush.setBadgeNumber(0)) - 登录态变化时(如用户登出),清除所有服务端 badge 记录(调 JPush REST API
/v3/users/{registration_id}/badge设为 0) - 鸿蒙 Next 必须用 UTS 编写原生桥接,例如通过
harmony.notification.setBadge({ number: 0 })调用系统能力,plus相关代码需用条件编译屏蔽
真正难的不是“怎么写那行代码”,而是判断当前运行环境是否支持、服务端是否已同步、用户是否关闭了通知权限——这三个条件缺一不可,漏掉任意一个,角标就卡在那儿不动。


















