Flutter iOS端Work Manager触发Firebase通知本地推送无响应求助

关键排查步骤 #

• 拉满Work Manager的iOS配置

  1. 核对Info.plist里的BGTaskSchedulerPermittedIdentifiers，任务ID必须和代码里注册的完全一致，不能差一个字符：

     <key>BGTaskSchedulerPermittedIdentifiers</key>
     <array>
         <string>com.your.app.notify_task</string>
     </array>
     

  2. AppDelegate里的初始化代码不能错，必须在didFinishLaunchingWithOptions里先注册任务再初始化Work Manager，示例代码：

     import Workmanager
     import UserNotifications
     
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
         FirebaseApp.configure()
         
         // 注册Work Manager任务
         WorkmanagerPlugin.registerTask(withIdentifier: "com.your.app.notify_task") { task in
             // 触发本地通知的逻辑，必须在30秒内完成
             let content = UNMutableNotificationContent()
             content.title = "Firebase通知触发"
             content.body = "收到后台通知"
             content.sound = UNNotificationSound.default
             
             let request = UNNotificationRequest(identifier: UUID().uuidString, content: content, trigger: nil)
             UNUserNotificationCenter.current().add(request) { error in
                 // 必须调用此方法告知系统任务完成状态
                 task.setTaskCompleted(success: error == nil)
             }
         }
         
         WorkmanagerPlugin.initialize()
         return true
     }
     

  划重点：iOS的BGTaskScheduler要求任务必须在30秒内结束，无论成功失败都要调用setTaskCompleted(success:)，否则系统会标记任务失败，后续可能不再调度。

• Firebase推送配置不能缺

  1. Xcode中必须开启后台模式：在Signing & Capabilities里添加Background Modes，勾选Remote notifications和Background fetch（Work Manager依赖后者运行后台任务）。
  2. 发送推送时必须携带content_available: true字段，否则iOS不会唤醒后台任务。用Firebase控制台发送时，在Advanced options里开启Content available；用API发送时，请求体需包含该字段：

     {
       "to": "DEVICE_TOKEN",
       "content_available": true,
       "data": {
         "type": "notify",
         "message": "Hello from Firebase"
       }
     }
     

• 验证任务调度状态

  1. 不要用模拟器测试！iOS模拟器对后台任务支持有限，必须用真实设备。
  2. 通过Xcode Debug工具查看：连接设备后，点击顶部菜单Debug -> Background Tasks，这里能看到所有被调度的后台任务，检查你的任务ID是否存在。
  3. 检查系统设置：确保App开启了“通知”和“后台App刷新”权限，否则iOS会直接拦截任务。

易踩坑点 #

• Work Manager的iOS实现仅支持iOS13及以上版本，低于该版本的设备无法使用，需做版本兼容处理。
• 任务ID必须采用反向域名格式（如com.your.app.task），不能包含特殊字符，否则注册成功也无法执行，且无报错提示。
• 应用被用户手动划掉（终止状态）时，iOS仅会在收到带content_available: true的推送时尝试唤醒任务，但成功率并非100%，系统会根据App活跃度和当前资源情况决定是否调度。

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