Flutter Workmanager iOS端应用终止后后台任务无法运行问题

已确认的前置场景 #

• 从GitHub拉取Workmanager源码修改，在回调分发器中加入自定义业务代码
• Xcode调试阶段，手动触发Background Fetch、应用最小化状态下，回调可正常执行，本地通知能正常弹出
• 应用被手动终止（从最近任务列表上滑移除进程）后，后台任务完全无法运行
• 已使用Release构建包测试，排除Debug模式配置干扰
• 自定义回调代码如下，代码执行前已完成通知相关依赖初始化：

for (int i = 0; i < 1000; i++) {
      await Future.delayed(const Duration(seconds: 5));
      AwesomeNotifications().createNotification(
          content: NotificationContent(
              id: 10,
              channelKey: 'basic_channel',
              title: i.toString(),
              body: 'Workmanager '));
      print("background $i");
    }
    await Future.delayed(const Duration(minutes: 15));

排查解决步骤 #

• 第一步先核对基础配置
  检查Info.plist的后台模式配置，必须勾选Background fetch、Background processing两个选项；同时确认BGTaskSchedulerPermittedIdentifiers数组中，已经完整加入Workmanager使用的所有任务标识符，标识符不匹配时系统根本不会唤醒应用进程调度任务。
  注意：不要用Xcode的模拟Background Fetch功能验证终止场景，这个模拟触发只在应用进程存活时生效，应用终止后的任务由系统独立调度，模拟能力完全覆盖不到这个场景。
• 第二步调整回调注册时机
  Workmanager的任务回调必须在AppDelegate的didFinishLaunchingWithOptions执行阶段就完成注册，不能等Flutter首页渲染完成后再注册。应用被系统后台唤醒时，只会走AppDelegate的启动流程，不会触发Flutter页面加载，注册时机过晚会导致系统找不到对应任务回调，直接终止唤醒流程。同时检查你修改的Workmanager原生代码，不要给回调注册加上“应用处于前台”“页面已加载”这类前置判断。
• 第三步修正任务代码逻辑适配iOS后台限制
  你当前写的任务逻辑完全不符合iOS后台执行规则，必然会被系统强杀：

  iOS给后台唤醒任务预留的执行时长上限仅30秒左右，你代码里写的千次循环每次等5秒、最后追加15分钟等待的逻辑，在应用终止后唤醒的场景下，只要执行超时就会被系统直接挂起进程，不可能持续运行。
  首先删掉长循环、长等待逻辑，任务唤醒后只做轻量操作，执行完成立刻调用Workmanager提供的任务完成回调，不要长期持有线程等待。其次你代码里通知id固定写死为10，就算任务正常执行，新通知也会覆盖旧通知，不会按预期弹出多条，需要改成动态id。最后要确认AwesomeNotifications的初始化逻辑，不能依赖Flutter常规启动流程里的初始化，要在后台任务回调入口第一时间完成插件注册，否则唤醒时插件未加载，通知根本发不出来。

• 第四步适配系统调度规则
  iOS在用户手动终止应用后，不会立刻调度该应用的后台任务，系统会结合用户使用习惯、设备电量、网络状态，间隔数小时后才会恢复对应应用的后台调度，刚杀完应用就等任务触发本身就不符合系统策略。另外测试终止后场景时不要连着Xcode，Xcode的调试挂载会打断系统原生的后台任务调度逻辑，需要打Release包装到真机，断开Xcode连接后等待系统自动调度验证。

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