如何查找APNs topic对应的正确bundle id以解决推送报错

DeviceTokenNotForTopic 错误的核心是推送请求携带的topic，和目标设备token绑定的授权topic不匹配，即便你核对过bundle ID，也可能是多环境、扩展模块、证书配置等隐藏问题导致的，按照以下步骤可快速定位到正确的topic并修复问题：

• 若使用P8类型的APNs认证密钥：
  • 密钥本身不绑定固定topic，主App推送的默认topic就是App的主bundle ID；如果推送对象是通知扩展、Watch独立App、App Clip等子模块，topic需对应子模块自己的bundle ID，不可复用主App的值
  • 注意区分环境：沙箱环境生成的设备token仅可匹配沙箱请求的topic，生产/TestFlight/企业分发包生成的token仅可匹配生产请求的topic，环境混用也会触发该报错
• 若使用P12类型的推送证书：
  • 打开macOS钥匙串访问，找到对应推送证书，展开详情页查看用户ID字段，该字段的值就是证书绑定的唯一合法topic，直接复制该值使用即可，不要手动填写bundle ID

• 在App注册推送获取device token的回调逻辑中，增加日志打印当前运行App的Bundle Identifier实际值。如果你的项目配置了多环境自动修改bundle ID（例如Debug环境自动添加.debug后缀），很大概率你填写的是Release环境的bundle ID，和测试包实际的bundle ID不符
• 如果是给App扩展、Watch App、App Clip等子模块推送，需打印对应子模块的bundle ID作为topic使用，和主App不通用

• 检查推送请求的apns-topic头字段值是否和上述两步拿到的topic完全一致，大小写必须完全匹配
• 确认你没有额外添加不必要的后缀：只有VoIP推送需要加.voip后缀、复杂表盘推送需要加.complication后缀，普通远程推送不要添加任何后缀，直接使用bundle ID即可

• 如果你近期修改过App的bundle ID、重新生成过推送证书，需要删除设备上的旧测试包重新安装，旧包绑定的仍是修改前的旧topic，用新凭证推送旧包会持续报错
• 不要给TestFlight、企业分发的生产包使用沙箱推送接口发送请求，两类包对应的是生产环境topic，必须调用生产环境的APNs接口

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