多设备推送时Firebase Messaging出现UNREGISTERED错误求助

可能原因分析 #

1. 后端令牌存储/关联逻辑错误
   这是最常见的诱因：如果后端系统限制同一用户账号仅能绑定单个FCM令牌，当新设备上传令牌时，后端会覆盖旧设备的令牌记录，甚至主动将旧令牌从有效列表中移除。后续推送旧设备时，使用的是已被后端标记为无效的令牌，FCM服务会返回UNREGISTERED。

2. 应用账号登录后的令牌同步逻辑缺陷
   若应用在多设备登录场景下，触发了错误的令牌清理逻辑（比如后端收到新令牌后，主动过滤掉旧令牌），或者前端上传令牌时误将其他设备的令牌覆盖，都会导致旧设备令牌无法被正常推送。

3. 签名/包名不匹配导致令牌失效
   若不同设备上的应用使用了不同签名（比如一台是debug签名，另一台是release签名），FCM会将其视为两个不同的应用实例，对应的令牌无法通用。如果后端混用了不同签名生成的令牌，推送时就会出现UNREGISTERED错误。

解决方案 #

1. 修复后端令牌管理逻辑 #

• 为同一用户账号维护多设备令牌列表，存储时采用追加而非覆盖逻辑，确保每个设备的令牌都能被独立保存；
• 移除后端中“同一账号仅保留最新令牌”的限制，除非用户主动注销设备，否则不删除旧令牌；
• 推送时严格根据目标设备的标识（比如设备ID、用户设备关联记录）选择对应令牌，避免错误使用其他设备的令牌。

2. 优化应用内令牌同步流程 #

• 实现FirebaseMessagingService的onNewToken方法，监听令牌自动刷新事件，确保新令牌生成后立即同步到后端，避免使用过期令牌；
• 应用启动时主动获取令牌并同步到后端，同时验证后端存储的令牌与本地令牌是否一致，若不一致则更新后端记录；
• 禁止在多设备登录场景下，触发任何跨设备的令牌删除操作（deleteToken()仅对本地设备有效，无法影响其他设备）。

3. 验证令牌有效性与应用配置 #

• 使用Firebase控制台的测试推送功能，分别向两个设备的令牌单独推送通知，确认令牌本身是否有效，排除后端推送逻辑的问题；
• 确保所有设备上的应用使用相同的签名和包名，debug和release环境的令牌不能混用，需分别存储和推送；
• 检查FCM推送接口的返回日志，UNREGISTERED的官方定义是令牌已被注销（应用卸载、签名变更、设备清除数据等），若单设备测试正常，可排除令牌本身的问题，聚焦后端逻辑。

4. 排查FCM令牌生命周期 #

• 监听应用的卸载、清除数据事件，若用户操作导致应用数据清除，令牌会失效，需在用户重新安装后同步新令牌；
• 避免频繁调用deleteToken()和getToken()，除非必要，否则依赖FCM自动刷新令牌的机制。

内容的提问来源于stack exchange，提问作者laurentmeurisse