Flutter iOS端Firebase getInitialMessage点击通知不触发跳转问题

原生配置层必查项 #

• 检查APNs能力配置：在Apple Developer后台对应App ID下开启Push Notifications能力，同时在Xcode的Signing & Capabilities页签添加Push Notifications，添加Background Modes并勾选Remote notifications。仅在info.plist写入UIBackgroundModes字段可能被Xcode构建配置覆盖，必须确认可视化配置页的开关为选中状态。
• 校验APNs证书有效性：Firebase控制台必须上传对应环境的APNs密钥/证书，debug调试包对应sandbox环境，TestFlight/正式发布包对应生产环境，证书上传后需等待3-5分钟生效，传错环境会导致推送完全无法下发或回调不触发。
• 禁用通知代理拦截：如果项目集成了其他推送类SDK（极光、个推等），这类SDK会Hook通知相关的系统代理方法，大概率拦截Firebase的点击回调，测试阶段可先移除其他推送SDK验证逻辑。
• 必须使用真机测试：iOS模拟器不支持APNs推送流程，所有推送相关测试必须在真机上进行。

代码逻辑问题修正 #

你当前的代码存在几处明确的逻辑错误，会直接导致iOS端点击事件丢失：

• 禁止重复调用getInitialMessage()：该方法仅在App完全杀进程状态下被通知冷启动时返回一次消息实例，第一次调用获取到值后，后续所有调用都会返回null。你在main.dart和pushNotificationService.dart中各调用了一次该方法，冷启动场景的消息会被第一处调用提前消费，后续逻辑拿不到参数。

  修正方案：全局仅保留一处getInitialMessage()调用，统一在通知服务初始化时处理冷启动场景逻辑。

• 补全iOS本地通知权限与展示逻辑：
  1. 你当前IOSInitializationSettings中把requestSoundPermission、requestBadgePermission、requestAlertPermission全设为false，会导致本地通知无交互权限，点击事件不会触发回调，需将对应权限配置改为true，或在App首次启动时主动调用权限申请方法。
  2. 你在FirebaseMessaging.onMessage监听中仅判断安卓通知实例存在时才弹本地通知，iOS前台收到通知时不会触发系统通知弹窗，自然没有点击入口，需补全iOS端的本地通知展示逻辑。
  3. flutterLocalNotificationsPlugin.initialize的onSelectNotification回调为空实现，iOS端前台展示的本地通知点击后会走该回调，不会触发Firebase的onMessageOpenedApp，需在该回调中补全参数解析和页面跳转逻辑。
• 修正监听注册与跳转时机：
  1. setupInteractedMessage方法必须在runApp执行后第一时间调用，不能等首页渲染完成或其他异步接口返回后再注册监听，否则App从后台被通知拉起时，点击回调已经触发但监听还未注册，直接导致事件丢失。
  2. 删除冷启动场景下固定等待4秒/6秒再跳转的逻辑，iOS端路由栈初始化速度和安卓存在差异，固定时长很容易出现navigatorKey还未绑定完成就调用跳转的问题，需改用WidgetsBinding.instance.addPostFrameCallback确认第一帧渲染完成、路由栈就绪后再执行跳转。
• 确保Firebase初始化时机正确：Firebase.initializeApp()必须在App启动入口优先执行，不要在页面加载完成后再初始化，否则冷启动场景的通知消息无法被正确接收。

推送Payload格式校验 #

iOS端对推送Payload格式要求比安卓严格，不符合规范的Payload不会触发点击回调：

• 后台/杀进程场景的推送必须携带"content-available": 1字段，否则系统不会把点击事件传递给Firebase SDK。
• 测试阶段优先用Firebase控制台发送通知验证，不要直接用自定义服务端拼接的Payload，排除字段拼写错误、结构错误问题。
• 如果Payload中携带"mutable-content": 1字段，必须对应配置Notification Service Extension，否则会导致通知加载异常，点击事件不触发。

其他易忽略细节 #

• 首次安装App时必须同意通知权限申请，拒绝权限后通知无法正常下发，自然不存在点击事件。
• 若App当前处于前台，iOS默认不会弹出系统通知横幅，必须调用setForegroundNotificationPresentationOptions（你已经配置了该段逻辑，确认其在通知监听注册前执行即可），同时手动触发本地通知展示，否则前台收通知时用户看不到通知入口。

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