OneSignal推送异常：Player ID数量与通知送达数不符问题排查

核心结论 #

必须对同一设备/用户关联的subscriptionIds做去重与有效性管理，这是解决推送数量差异问题的关键。

原因解析 #

OneSignal在处理推送请求时，会自动过滤以下类型的Player ID：

• 同一设备生成的旧订阅ID：同一设备每次重新订阅（比如登录、重装APP）会生成新的Player ID，旧ID会被标记为无效或未订阅状态，OneSignal不会向这类ID推送通知。
• 重复的Player ID：数组中重复的ID会被合并处理，只推送一次。
• 已取消订阅、设备卸载APP或标记为无效的ID：这类ID会被直接跳过，不会计入实际推送队列。

结合你的测试场景：多人共用测试账户，每次登录新增ID但登出未清理，导致数据库中积累了大量同一设备的旧ID、无效ID。当你传入14个ID的数组时，OneSignal仅识别其中3个有效的ID（对应3台活跃设备），所以后台显示3条送达；而单独保留你的最新ID时，该ID是有效状态，因此能收到通知；恢复数组后能收到，是因为你的最新ID在数组中被识别，其他无效ID被自动过滤。

关于OneSignal标记“所有通知为已送达”：API返回的“成功”是指请求提交成功，但实际后台会对ID做有效性校验，只有有效ID会被推送，无效ID会被跳过，这就导致了提交数量与实际送达数量的差异。

具体处理方案 #

• 按设备维度去重：
  给每个设备绑定唯一标识（比如Android的设备UUID、iOS的IDFV），在数据库中维护“设备标识 -> 最新subscriptionId”的映射关系。每次用户登录生成新ID时，替换该设备对应的旧ID，直接删除数据库中的旧记录，避免同一设备存在多个订阅ID。
• 完善登出清理逻辑：
  用户登出时，同时执行两个操作：
  1. 调用OneSignal的DELETE /players/{player_id}接口，将该订阅ID标记为无效。
  2. 从数据库中删除对应的subscriptionId记录，避免残留无效数据。
• 推送前预处理：
  每次发起推送请求前，对player_ids数组做两步处理：
  1. 去重：移除数组中的重复ID。
  2. 有效性校验：定期批量调用OneSignal的GET /players接口，获取ID的状态（status字段），过滤掉invalid、not_subscribed状态的ID，只保留active状态的ID再发起推送。
• 定期清理无效数据：
  每周或每月执行一次数据库清理任务，调用OneSignal接口校验所有存储的subscriptionId有效性，删除无效ID，减少无效数据积累。

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