设备重启后如何自动恢复Flutter的WorkManager后台进程？

要让WorkManager的后台任务在设备重启后自动恢复，核心是确保任务被持久化，同时配置Android系统所需的权限和WorkManager的正确初始化，以下是具体步骤：

1. 确保WorkManager依赖版本达标 #

Android端的WorkManager从2.3.0版本开始默认支持设备重启后自动恢复持久化任务，所以要保证你的项目依赖的WorkManager版本不低于这个值。如果使用Flutter的workmanager插件，尽量使用最新稳定版（比如0.5.x及以上），插件会自动处理底层依赖。

2. 添加系统权限 #

在Android项目的android/app/src/main/AndroidManifest.xml中添加开机启动权限：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

3. 创建持久化的WorkRequest #

在Flutter代码中创建WorkRequest时，必须开启持久化标记，这样系统重启后WorkManager才会恢复该任务：

import 'package:workmanager/workmanager.dart';

void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) {
    // 你的后台任务逻辑
    return Future.value(true);
  });
}

void initWorkManager() {
  Workmanager().initialize(
    callbackDispatcher,
    isInDebugMode: false,
  );

  // 创建持久化的周期性任务
  Workmanager().registerPeriodicTask(
    "unique-background-task",
    "daily-sync-task",
    frequency: Duration(hours: 24),
    initialDelay: Duration(minutes: 10),
    existingWorkPolicy: ExistingWorkPolicy.replace,
    constraints: Constraints(
      networkType: NetworkType.connected,
    ),
    // 关键：开启任务持久化
    persisted: true,
  );
}

4. 自定义WorkManager初始化（可选） #

如果你的项目使用了自定义WorkerFactory或者需要自定义初始化逻辑，需要在AndroidManifest.xml中配置自定义Initializer，避免默认初始化被覆盖：

<application ...>
  <provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    android:exported="false"
    tools:node="merge">
    <meta-data
      android:name="androidx.work.WorkManagerInitializer"
      android:value="androidx.startup"
      tools:node="remove" />
  </provider>

  <!-- 注册自定义Initializer -->
  <provider
    android:name="com.yourapp.package.CustomWorkManagerInitializer"
    android:authorities="${applicationId}.workmanager-init"
    android:exported="false" />
</application>

自定义Initializer需要实现Initializer<WorkManager>接口，确保初始化过程中启用持久化支持。

关键注意事项 #

• 国产ROM后台限制：小米、华为、OPPO等国产系统有严格的省电管控，即使配置正确，任务可能仍无法自动恢复。需引导用户为应用开启「自启动权限」「后台运行权限」，并关闭针对该应用的省电模式。
• 任务唯一性：每个任务的唯一标识（第一个参数）必须唯一，避免重复注册导致任务冲突。
• Android 12+适配：Android 12及以上版本对后台启动有严格限制，尽量将任务绑定到充电、联网等约束条件上，提升任务执行成功率。

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