Flutter_background_service在部分Android设备中停止运行问题排查

一、权限与Android 14适配遗漏 #

• 除了FOREGROUND_SERVICE_HEALTH，Android 14要求前台服务启动时必须显式指定服务类型。检查代码中是否通过FlutterBackgroundServiceAndroid.configure设置了foregroundServiceType: AndroidForegroundType.health——仅在Manifest中声明权限，代码未指定类型的话，系统可能在进程回收后拒绝服务重启，甚至直接禁用通知。
• 确认是否动态申请了ACTIVITY_RECOGNITION权限。步数统计依赖运动传感器，这个权限必须动态请求（哪怕Manifest已声明），部分设备后台运行数天后，系统会自动收回该权限，导致计步器无法注册，服务重启后核心功能也会失效。
• 核对Manifest权限声明是否完整：

  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_HEALTH" />
  <uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
  <uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- 避免CPU深度休眠导致进程被杀 -->
  

二、服务重启逻辑的缺陷 #

• 调用initializeService()前，先检查服务状态：如果服务被系统杀死后直接初始化，可能无法触发正确的重启流程。建议先判断服务是否运行，若已运行则先停止再重启：

  bool isRunning = await FlutterBackgroundService().isRunning();
  if (isRunning) {
    await FlutterBackgroundService().invoke("stopService");
    await Future.delayed(const Duration(seconds: 1)); // 等待进程完全退出
  }
  await FlutterBackgroundService().configure(...);
  

• 检查服务onStart回调中是否重新注册了计步器监听。服务重启后必须重新绑定传感器事件，否则会出现服务运行但不统计步数的情况，不要只在首次启动时初始化计步器。

三、通知图标规范与缓存问题 #

• 安卓要求通知图标必须是透明背景的单色图标（通常为白色），不符合规范的图标会被系统替换为默认图标。检查drawable目录下的图标是否适配了所有分辨率（hdpi、xhdpi等），且符合系统规范。
• 初始化flutter_local_notifications时，确保AndroidInitializationSettings的defaultIcon指向正确的资源名称（不带扩展名）：

  final AndroidInitializationSettings initializationSettingsAndroid =
      AndroidInitializationSettings('ic_notification'); // 确认该图标存在于所有分辨率目录
  

• 部分厂商会缓存通知图标，重启服务后仍可能使用旧缓存。建议在构建通知时显式指定图标：

  await flutterLocalNotificationsPlugin.show(
    0,
    "步数统计",
    "$currentStep 步",
    NotificationDetails(
      android: AndroidNotificationDetails(
        'step_channel',
        '步数统计',
        icon: 'ic_notification', // 强制指定图标
        foregroundServiceType: AndroidForegroundServiceType.health,
      ),
    ),
  );
  

四、设备厂商后台限制 #

• 小米、华为、OPPO等厂商的电池优化策略会主动杀死后台服务，甚至阻止重启。需要引导用户将APP加入后台运行白名单、开启自启动权限，并设置“无限制电池使用”。
• 部分厂商会对长时间运行的前台服务通知做限制，比如自动隐藏或替换图标。可以尝试定期更新通知内容（比如每分钟刷新步数），让系统认为服务处于活跃状态，降低被回收的概率。

五、计步器绑定的生命周期问题 #

• 步数统计依赖Sensor.TYPE_STEP_COUNTER传感器，服务重启时必须重新注册传感器监听，且在服务停止时正确注销：

  void registerStepCounter() {
    sensorManager?.registerListener(
      stepListener,
      sensorManager?.getSensor(Sensor.TYPE_STEP_COUNTER),
      SensorManager.SENSOR_DELAY_NORMAL,
    );
  }
  

• 部分设备深度休眠后传感器会停止工作，可使用WAKE_LOCK保持CPU唤醒，或监听设备唤醒事件，在设备唤醒时重新激活传感器。

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