Flutter_background_fetch在Android应用终止后失效问题求助

问题说明 #

使用flutter_background_fetch插件的Flutter Android应用，在前台/后台状态下每15分钟能正常触发通知，但应用完全终止后，background_fetch停止工作，无法执行任务或弹出通知。已按文档设置stopOnTerminate: false，但问题仍存在。

现有代码片段 #

主文件配置 #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  BackgroundFetch.registerHeadlessTask(backgroundFetchHeadlessTask);
  initializeNotificationService();
  runApp(const MyApp());
}

@pragma('vm:entry-point')
void backgroundFetchHeadlessTask(HeadlessTask task) async {
  String taskId = task.taskId;
  bool isTimeout = task.timeout;
  if (isTimeout) {
    BackgroundFetch.finish(taskId);
    return;
  }
  // Do your work here...
  BackgroundFetch.finish(taskId);
}

Controller配置 #

class Controller extends GetxController {
  
  @override
  void onInit() {
    super.onInit();
    startListeningNotificationEvents();
    initPlatformState();
  }
  
  Future<void> initPlatformState() async {
    var status = await BackgroundFetch.configure(
        BackgroundFetchConfig(
          minimumFetchInterval: 15,
          forceAlarmManager: false,
          stopOnTerminate: false,
          startOnBoot: true,
          enableHeadless: true,
          requiresBatteryNotLow: false,
          requiresCharging: false,
          requiresStorageNotLow: false,
          requiresDeviceIdle: false,
          requiredNetworkType: NetworkType.NONE,
        ),
        _onBackgroundFetch,
        _onBackgroundFetchTimeout);
    BackgroundFetch.scheduleTask(TaskConfig(
        taskId: "test",
        delay: 1000,
        periodic: false,
        stopOnTerminate: false,
        enableHeadless: true));
    BackgroundFetch.start();
  }

  void _onBackgroundFetchTimeout(String taskId) {
    //BackgroundFetch.finish(taskId);
  }
    
  void _onBackgroundFetch(String taskId) async {
    if (taskId == "test") {
      random();
      createNotification();
    }
  }
}

解决步骤 #

1. 强制使用AlarmManager #

Android 8.0+的Doze模式和App Standby会限制JobScheduler的执行，AlarmManager优先级更高，不易被系统拦截。修改BackgroundFetchConfig：

BackgroundFetchConfig(
  minimumFetchInterval: 15,
  forceAlarmManager: true, // 把false改为true
  stopOnTerminate: false,
  startOnBoot: true,
  enableHeadless: true,
  // 其他配置保持不变
)

2. 在HeadlessTask中执行实际任务 #

应用终止后，系统只会触发HeadlessTask，而非普通的_onBackgroundFetch方法。当前的HeadlessTask只是空执行，需要把任务逻辑移进去：

@pragma('vm:entry-point')
void backgroundFetchHeadlessTask(HeadlessTask task) async {
  String taskId = task.taskId;
  bool isTimeout = task.timeout;
  if (isTimeout) {
    BackgroundFetch.finish(taskId);
    return;
  }
  // 这里执行你的任务逻辑
  if (taskId == "test") {
    random();
    createNotification();
  }
  BackgroundFetch.finish(taskId);
}

注意：HeadlessTask在独立Isolate运行，要确保random()和createNotification()能在该环境正常工作（比如提前初始化通知服务）。

3. 配置Android后台权限 #

• 添加权限到AndroidManifest.xml：

<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

• 引导用户忽略电池优化：

import 'package:android_intent_plus/android_intent.dart';
import 'package:package_info_plus/package_info_plus.dart';

void requestIgnoreBatteryOptimizations() async {
  final packageName = (await PackageInfo.fromPlatform()).packageName;
  final intent = AndroidIntent(
    action: 'android.settings.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS',
    data: 'package:$packageName',
  );
  await intent.launch();
}

4. 修正定时任务配置 #

当前scheduleTask设置periodic: false，任务只会执行一次。如果需要周期性触发，改为：

BackgroundFetch.scheduleTask(TaskConfig(
    taskId: "test",
    delay: 1000,
    periodic: true, // 改为true
    interval: 15, // 间隔15分钟（系统最小限制）
    stopOnTerminate: false,
    enableHeadless: true));

5. 适配国产ROM #

小米、华为、OPPO等国产ROM有更严格的后台管控，需要手动给应用开启：

• 自启动权限
• 后台运行权限
• 无限制电池使用权限

测试注意事项 #

不要用Android Studio的「终止应用」按钮测试，这会模拟强制杀死，无法触发HeadlessTask。正确方式是从最近应用列表划掉应用。

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