Flutter iOS后台服务异常：后台进程20秒后暂停问题求助

1. 先搞懂iOS的后台限制 #

iOS和Android不一样，普通APP进后台后20秒左右就会被系统挂起，这是系统硬限制，不是你用的那些三方包有问题。只有特定后台模式下，系统才会允许APP持续活跃，比如运动、定位、音频这类场景。

2. 配置iOS后台权限（必做） #

在ios/Runner/Info.plist里添加以下配置：

• 运动权限申请描述（计步功能必须）：

  <key>NSMotionUsageDescription</key>
  <string>需要访问运动数据统计步数</string>
  

• 后台模式开启：

  <key>UIBackgroundModes</key>
  <array>
      <string>motion</string> <!-- 核心：对应计步场景的运动更新后台模式 -->
      <string>processing</string> <!-- 辅助后台处理逻辑 -->
  </array>
  

如果你的计时功能需要和定位绑定（比如户外跑步计时），可以额外添加location模式。

3. 三方包的适配调整 #

flutter_foreground_task #

这个包是iOS后台场景适配相对靠谱的选择，但要注意：

• 必须配置前台通知：iOS要求后台持续运行的APP必须显示常驻前台通知，否则会直接终止进程。在Info.plist补充：

  <key>NSForegroundUsageDescription</key>
  <string>后台持续记录步数和计时</string>
  

• 启动任务时设置iOS专属配置：

  await FlutterForegroundTask.startService(
    notificationTitle: '正在计步',
    notificationText: '后台运行中',
    iosNotificationSettings: const IOSNotificationSettings(
      isPersistent: true, // 通知常驻不消失
      showNotification: true,
    ),
  );
  

workmanager #

别用这个做实时计步/计时！它在iOS上基于Background App Refresh机制，任务触发间隔至少15分钟，完全不满足实时更新需求，仅适合定时同步这类非实时任务。

flutter_background_service #

这个包需要在AppDelegate.swift里手动配置后台任务启动逻辑，确保iOS系统能识别到你的后台任务。同时必须绑定motion或location这类合法后台模式，否则还是会被系统挂起。

4. 避坑提醒 #

• 必须用真机测试：模拟器的后台行为和真机差异极大，模拟器上的测试结果没有参考性。
• 精简后台逻辑：后台只保留计步统计、计时的核心代码，避免耗时操作，系统会优先保留资源占用低的后台进程。
• 合规性注意：如果APP仅做纯计时，未绑定运动、定位这类系统允许的后台行为，就算配置了权限，上线时也可能被App Store审核拒绝——iOS不允许无意义的后台持续运行。

内容的提问来源于stack exchange，提问作者Don Arias Agokoli