Flutter开发iOS端应用无法接收Firebase推送通知问题

从你给出的信息看，FCM接口返回成功仅代表消息被FCM服务端接收，不代表消息成功投递到设备，按优先级从高到低排查以下问题：

1. iOS原生配置缺失/错误（占这类问题的80%以上） #

• 检查Xcode项目能力配置：打开Runner.xcworkspace，在Signing & Capabilities中确认添加了Push Notifications能力，同时添加Background Modes能力并勾选其中的Remote notifications选项，漏配这两项会导致APNs通道无法建立。
• 检查Firebase控制台的APNs证书配置：
  • 用真机Debug包测试时，必须上传对应Apple开发环境的APNs证书/配置正确的.p8密钥，且.p8对应的Key ID、Team ID和Apple开发者后台完全一致
  • 用TestFlight/AdHoc/AppStore包测试时，必须上传生产环境APNs证书，证书环境和测试包环境不匹配时，FCM会返回成功但APNs会直接丢弃消息，设备完全收不到
• 不要用iOS模拟器测试推送：除Xcode 14+的模拟推送功能外，常规iOS模拟器不支持APNs真实通道推送，必须用真机测试。

2. Postman推送Payload配置错误 #

FCM下发iOS推送时必须携带APNs专属配置，否则会被系统拦截/静默丢弃，正确的Payload示例如下：

{
  "to": "你的设备FCM token",
  "priority": "high",
  "notification": {
    "title": "测试通知标题",
    "body": "测试通知内容"
  },
  "apns": {
    "headers": {
      "apns-priority": "10"
    },
    "payload": {
      "aps": {
        "sound": "default",
        "badge": 1,
        "content-available": 1
      }
    }
  }
}

常见Payload错误：

• 未设置apns-priority:10，低优先级推送会被iOS系统限流、延迟甚至不投递
• Debug包测试时未指定推送到APNs沙箱环境
• 只传了data字段没传notification字段，且未配置静默通知相关参数

3. 代码逻辑问题 #

• 初始化时序错误：你在initState中先调用了异步的requestAndRegisterNotification()，之后才给_totalNotifications赋值为0。如果通知回调在赋值前触发，执行_totalNotifications++时会直接抛出空异常，导致onMessage监听逻辑中断，通知弹窗代码根本不会执行。正确顺序是先初始化_totalNotifications = 0，再调用通知注册方法。
• 后台消息回调配置错误：_firebaseMessageingBackgroundHandler必须是顶级全局函数或者类的静态方法，不能是类的实例方法，否则App在后台/进程终止状态下无法找到回调入口，消息处理失败。
• 前台通知展示逻辑缺失：iOS默认前台收到推送不会弹出系统通知横幅，你当前用的showSimpleNotification是应用内UI组件，必须确保onMessage回调正常触发才会展示，如果回调被异常中断就不会有任何提示。

4. 设备端限制 #

• 检查iOS设备的系统通知设置，确认已给测试App开启通知权限，没有开启专注模式屏蔽该App通知，没有将App通知设置为静默交付。
• 如果设备网络开启了代理/VPN，尝试关闭后重试，部分代理会拦截APNs的长连接。

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