You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Firebase Cloud Messaging单设备推送成功,批量推送失败求助

处理FCM多设备推送中注销令牌的问题

首先,先明确一点:当你向包含已注销令牌的设备列表推送时,FCM返回的结果里会明确标记哪些令牌失败以及失败原因——这是完全正常的行为,不用慌。

先给你拆解下这种场景下的典型返回结构(假设你收到的是类似这样的结果):

{"multicast_id":1234567890123456789,"success":1,"failure":2,"canonical_ids":0,"results":[{"message_id":"0:123456789012345%abcdefabcdef"},{"error":"InvalidRegistration"},{"error":"InvalidRegistration"}]}

针对这个情况,你需要做这几件事:

  • 解析返回的results数组:这个数组里的每一项和你传入的设备令牌是一一对应的。比如你传的三个令牌顺序是[有效令牌, 注销令牌A, 注销令牌B],那results里的第一项就是有效令牌的推送结果,后两项就是失败的。
  • 处理失败的令牌:如果返回的error是InvalidRegistration或者NotRegistered,这就意味着这个设备令牌已经失效(用户卸载了应用、注销了账号或者令牌过期),你应该从你的数据库里把这个令牌删掉,避免后续再浪费推送资源。
  • 验证推送请求格式:确保你在curl请求里是把多个令牌放在registration_ids数组里,格式类似这样:
curl -X POST "https://fcm.googleapis.com/fcm/send" \
     -H "Authorization: key=YOUR_SERVER_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "registration_ids": ["TOKEN1", "TOKEN2", "TOKEN3"],
           "notification": {
             "title": "Test Notification",
             "body": "Hello from FCM!"
           }
         }'

另外给你几个小提示:

  • 每次推送后一定要处理返回的失败结果,及时清理无效令牌,这能提升后续推送的成功率,也能减少不必要的请求开销。
  • 如果遇到canonical_ids不为0的情况,说明FCM返回了更新后的有效令牌(比如设备重新生成了令牌),你需要用返回的registration_id替换数据库里旧的令牌。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.20 07:17:20