Flutter iOS推送通知调试模式正常但发布模式不显示问题求助

我之前也碰到过和你几乎一样的情况——调试模式推送正常，切到发布模式就没反应，折腾了好一阵才解决。结合你的配置，给你几个针对性的排查和解决方向：

1. 确认APNs证书与环境匹配 #

调试模式用的是Development类型的APNs证书，而发布模式必须对应Production证书：

• 登录Apple开发者后台，检查你的App ID已开启Push Notifications，并且Production证书已生成、下载，在Xcode的Signing & Capabilities里正确关联（如果用自动签名，确保Release配置下Push Notifications是勾选状态）。
• 推送服务器必须切换到Production环境的APNs地址：api.push.apple.com:443，别在发布模式下还调用Development的服务器（api.development.push.apple.com:443）。

2. 调整双推送包的集成配置 #

你同时用了flutter_apns和firebase_messaging，两者的swizzling配置很关键。试试把Info.plist的配置固定成下面这样：

<key>flutter_apns.disable_firebase_core</key> <false/>
<key>flutter_apns.disable_swizzling</key> <true/>
<key>FirebaseAppDelegateProxyEnabled</key> <false/>

同时在Flutter代码里调整初始化顺序，先初始化Firebase，再启动flutter_apns的推送服务：

// 先初始化Firebase
await Firebase.initializeApp();
await FirebaseMessaging.instance.requestPermission();

// 再配置flutter_apns
final pushConnector = createPushConnector();
pushConnector.configure(
  onLaunch: (message) => _handleNotification(message),
  onResume: (message) => _handleNotification(message),
  onMessage: (message) => _handleNotification(message),
);

3. 检查Xcode Release配置的权限细节 #

切换到Xcode的Release配置，逐一确认：

• 在Signing & Capabilities中，Background Modes下的Remote notifications和Background fetch必须勾选。
• 查看Info.plist源码，确保UIBackgroundModes数组包含对应项：

  <key>UIBackgroundModes</key>
  <array>
    <string>fetch</string>
    <string>remote-notification</string>
  </array>
  

4. 验证推送令牌的环境一致性 #

发布模式下获取的APNs令牌是Production环境的，和调试模式的令牌完全不同：

• 在代码里添加日志打印令牌，确认Release版本拿到的是Production令牌，然后用这个令牌测试推送（比如用Pusher等工具），别误用调试模式的令牌。

5. 检查设备端的通知权限 #

有时候发布模式下权限请求可能没正常触发，或者用户误操作关闭了权限：

• 在代码里添加权限检查逻辑，确保用户已授权通知：

  final notificationSettings = await FirebaseMessaging.instance.getNotificationSettings();
  if (notificationSettings.authorizationStatus != AuthorizationStatus.authorized) {
    await FirebaseMessaging.instance.requestPermission(
      alert: true,
      badge: true,
      sound: true,
    );
  }
  

• 手动打开iPad的设置 > 你的App > 通知，确认所有通知权限（允许通知、显示横幅等）都已开启。

6. 排查打包配置问题 #

打包Release版本时，确保用的是Ad Hoc或App Store Distribution配置，而非Debug配置。另外，Archive时确认没有遗漏必要的打包选项（比如符号表，虽然和推送无关，但配置错误可能引发连锁问题）。

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