开发环境下基于APNS HTTP/2测试推送通知的配置问题咨询

兄弟，我太懂你这种把所有组合试遍还是踩坑的痛苦了！之前我也因为APNS环境混配折腾了大半天，尤其是BadDeviceToken这个报错，几乎都是环境不匹配导致的。咱们把APNS开发/生产环境的配置对应关系掰扯清楚，你对照着排查肯定能解决！

APNS的开发（Sandbox）和生产（Production）环境是完全隔离的，证书、端点、Device Token三者必须严格对应，差一个环节都会报错。

一、开发环境（Debug调试用）的正确组合 #

• APNS端点：必须用 https://api.development.push.apple.com:443
• 推送证书：要在Apple Developer后台创建「Apple Development iOS Push Services」类型的证书，创建时选择Development环境，且Bundle ID和你的App完全一致
• Xcode配置细节：
  • Build Configuration必须选Debug
  • Signing & Capabilities里的「Push Notifications」要确保启用，并且关联的Provisioning Profile是开发类型的（包含开发推送权限）
  • 从Debug运行的App里获取Device Token——这个Token只对Sandbox端点有效，发给生产端点直接会返回BadDeviceToken

二、生产环境（Ad Hoc/TestFlight/App Store用）的正确组合 #

• APNS端点：必须用 https://api.push.apple.com:443
• 推送证书：要创建「Apple Production iOS Push Services」类型的证书，选择Production环境，Bundle ID和App严格匹配
• Xcode配置细节：
  • Build Configuration选Release
  • Provisioning Profile是生产类型的（Ad Hoc、TestFlight或App Store版本，必须包含生产推送权限）
  • 从Release打包安装的App里获取Device Token——这个Token只对Production端点有效

三、BadDeviceToken的高频排查点（你大概率踩了其中一个） #

• Token与环境不匹配：这是Top1原因！比如用Debug环境拿到的Token去调用生产端点，或者反过来，哪怕证书对了也没用
• 证书Bundle ID不匹配：不管开发还是生产证书，Bundle ID必须和App的完全一致，多一个大小写、后缀都不行
• Token格式错误：从Xcode日志里拿到的Token可能带<>或者空格，一定要清理成纯十六进制字符串（比如把<abc123>改成abc123）
• Provisioning Profile权限失效：去Apple Developer后台检查你的Profile，确认「Push Notifications」权限是勾选状态，然后重新下载替换Xcode里的旧Profile
• 开发环境设备未注册：Debug模式下，测试设备必须添加到Apple Developer后台的「Devices」列表里，否则Sandbox APNS会拒绝请求

四、快速验证步骤 #

1. 先锁定Debug模式：Xcode切到Debug，运行App获取Token，用开发证书调用Sandbox端点发推送，看是否能收到
2. 再验证Release模式：打包Ad Hoc安装到测试设备，获取Token，用生产证书调用Production端点发推送
3. 如果其中一步成功、一步失败，直接定位到环境混配问题；如果都失败，重点检查证书和Bundle ID的匹配，以及Profile的权限

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