Flutter iOS端Workmanager后台任务注册失败问题求助

BGTaskSchedulerErrorDomain error 3 对应苹果官方定义的 BGTaskSchedulerErrorNotPermitted，核心原因是任务标识符未被系统允许或任务注册方式冲突。结合你的代码，主要问题出在iOS端重复注册任务、配置不匹配两个方面。

1. 移除AppDelegate中手动注册任务的冗余代码 #

workmanager的Flutter端已负责任务注册，iOS端无需在AppDelegate.swift中手动调用WorkmanagerPlugin.registerPeriodicTask，这会导致重复注册冲突。修改后的代码如下：

import UIKit
import Flutter
import workmanager
import flutter_local_notifications

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
 override func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
                  completionHandler([.alert, .badge, .sound])
  }

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)
        // 设置插件注册回调，确保后台任务能初始化Flutter插件
        WorkmanagerPlugin.setPluginRegistrantCallback { registry in
            GeneratedPluginRegistrant.register(with: registry)
        }
        if #available(iOS 10.0, *) {
            UNUserNotificationCenter.current().delegate = self as UNUserNotificationCenterDelegate
        }
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }

    override func application(
        _ application: UIApplication,
        performFetchWithCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void){
        // 委托workmanager处理后台fetch任务
        WorkmanagerPlugin.fetchBackgroundTasks(completionHandler: completionHandler)
    }
}

2. 修正Flutter端任务配置，符合iOS限制 #

iOS对周期性后台任务有严格限制：最小执行间隔为15分钟，系统会根据应用活跃度调整实际执行频率，无法保证精准调度。调整你的main.dart中任务注册代码：

Workmanager().registerPeriodicTask(
  "NAME_NOTIFICATION_TASK", // 唯一任务名称，无需在Info.plist配置
  "notification_task", // 任务标识符，必须与Info.plist中完全一致
  initialDelay: Duration(seconds: 10),
  frequency: Duration(minutes: 15), // iOS允许的最小间隔
  existingWorkPolicy: ExistingWorkPolicy.replace,
  // 添加iOS专属约束，适配后台任务类型
  constraints: Constraints(
    networkType: NetworkType.connected, // 根据业务需求调整
    requiresBatteryNotLow: false,
  ),
);

3. 验证Info.plist与Xcode后台模式配置 #

• 确保BGTaskSchedulerPermittedIdentifiers中的标识符与Flutter端taskIdentifier完全一致，无拼写/大小写错误：

<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
    <string>notification_task</string>
</array>
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>processing</string>
</array>

• 打开Xcode的Capabilities > Background Modes，手动勾选Background fetch和Background processing选项（仅修改Info.plist可能不被系统识别）。

4. 调试与权限补充 #

• 使用真实设备测试：iOS模拟器对后台任务支持有限，无法完全模拟真实场景。
• 验证通知权限：在Flutter初始化时添加iOS通知权限请求：

await flutterLocalNotificationsPlugin.resolvePlatformSpecificImplementation<IOSFlutterLocalNotificationsPlugin>()?.requestPermissions(
  alert: true,
  badge: true,
  sound: true,
);

• 检查系统后台权限：在iOS设置>通用>后台App刷新中，确认你的应用已开启后台刷新。

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