Flutter iOS端Firebase通知操作按钮不显示且功能失效问题排查

看起来你已经在Android端搞定了通知操作按钮，但iOS这边掉链子了——既不显示按钮，点击后的动作也没反应。我帮你梳理几个关键排查点，都是iOS通知特有的坑：

1. 别漏了给Firebase推送Payload加Category标识 #

你的Flutter代码里定义了invitation_category这个通知分类，但Firebase远程推送的时候，默认不会自动关联这个分类！iOS根本不知道要给这条通知显示哪个按钮组。

• 如果用Firebase控制台推送：
  进到「高级选项」→「自定义数据」，添加一条键为category，值为invitation_category的条目。
• 如果用Firebase Cloud Messaging API推送：
  在APNs的Payload里明确指定category字段，示例如下：

  {
    "apns": {
      "payload": {
        "aps": {
          "category": "invitation_category",
          "alert": {
            "title": "邀请通知",
            "body": "有人邀请你加入委员会"
          }
        }
      }
    },
    "data": {
      "committeeId": "123",
      "invitationId": "456"
    }
  }
  

2. 原生端手动注册通知分类更可靠 #

虽然你的Flutter代码里配置了notificationCategories，但有时候Flutter插件的初始化时机可能晚于iOS系统的通知注册流程，导致分类没生效。建议在iOS原生代码里补一份注册：

Swift版AppDelegate示例： #

import UserNotifications
import FlutterLocalNotificationsPlugin

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化Firebase等其他配置...
    
    // 手动注册通知分类
    let acceptAction = UNNotificationAction(identifier: "accept_invitation", title: "Accept", options: .foreground)
    let rejectAction = UNNotificationAction(identifier: "reject_invitation", title: "Reject", options: .destructive)
    let invitationCategory = UNNotificationCategory(
        identifier: "invitation_category",
        actions: [acceptAction, rejectAction],
        intentIdentifiers: [],
        options: .hiddenPreviewShowTitle
    )
    
    UNUserNotificationCenter.current().setNotificationCategories([invitationCategory])
    
    // 初始化Flutter本地通知插件
    let flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin()
    flutterLocalNotificationsPlugin.setPluginRegistrantCallback { registry in
        GeneratedPluginRegistrant.register(with: registry)
    }
    
    return true
}

3. 确保终止/后台状态下的事件能传递到Flutter #

iOS在App终止状态下点击通知按钮，事件会先走到原生的通知回调里，你需要把这个事件转发给Flutter的通知插件，不然Flutter端的handleAppLaunchNotificationAction根本收不到。

在Swift的AppDelegate里添加这个方法：

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    let flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin.instance()
    flutterLocalNotificationsPlugin.handleNotificationResponse(response, completionHandler: completionHandler)
}

4. 检查闪屏页的动作处理时机 #

你提到在闪屏页基于type处理动作，要确保handleAppLaunchNotificationAction是在Flutter初始化完成后调用的，比如放在闪屏页的initState里：

@override
void initState() {
  super.initState();
  // 等通知服务初始化完成后再处理启动事件
  Future.delayed(const Duration(milliseconds: 500), () {
    NotificationService().handleAppLaunchNotificationAction().then((_) {
      // 这里根据actionId做对应的跳转或逻辑处理
    });
  });
}

最后几个必查的基础配置 #

• 用真机测试：iOS模拟器对通知的支持有限，很多操作按钮的逻辑在模拟器上不生效。
• 开启Xcode的Push Notifications权限：在项目的Capabilities里确认Push Notifications是开启状态。
• 开启Background Modes：同样在Capabilities里，勾选「Remote notifications」，确保App在后台能接收通知事件。

按照这些步骤排查下来，应该能解决iOS端按钮不显示和动作失效的问题。

备注：内容来源于stack exchange，提问作者Muhammad Umair