WorkManager：可靠的后台任务调度方案（Android Jetpack）
Android的后台任务调度，一直是开发者面临的难题。早期的Service、AlarmManager、JobScheduler，再到Firebase JobDispatcher——这一系列工具虽然能解决问题，但开发者需要手动处理Doze模式、API版本差异、任务持久化、网络切换重试等复杂场景。代码量巨大，且稍有不慎就会引发Bug。
直到WorkManager出现，局面才真正扭转。它是Jetpack推出的统一后台任务调度框架，底层会自动选择最合适的调度器：API 23以上使用JobScheduler，以下则利用AlarmManager加BroadcastReceiver。但对开发者而言，暴露的API完全一致。你只需定义“做什么”和“什么时候做”，剩下的可靠性保证——即使应用退出或设备重启，任务也能恢复执行——统统交给WorkManager处理。
一句话总结：WorkManager最适合那些“非做不可、但不用马上执行”的任务，比如日志上传、数据库清理、定期同步等后台作业。
核心概念
涉及三个关键角色：Worker（任务执行单元）、WorkRequest（调度指令），以及WorkManager自身的调度保证。
Worker：任务的执行单元
Worker是一个抽象类，你在doWork()方法中编写实际逻辑，最后返回Result.success()、Result.failure()或Result.retry()即可控制任务生命周期。
class UploadLogWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
override fun doWork(): Result {
return try {
// 执行上传逻辑（例如HTTP请求）
Result.success()
} catch (e: Exception) {
Result.retry() // 失败时自动触发重试策略
}
}
}
WorkRequest：任务的调度指令
WorkRequest告诉WorkManager这个任务应该怎样执行。有两种类型：OneTimeWorkRequest用于一次性任务，PeriodicWorkRequest用于定期任务（最小间隔15分钟）。两者都支持添加约束条件，比如“仅在联网时执行”“仅在充电时执行”“设备空闲时执行”等。
WorkManager的调度保证
需要特别强调：WorkManager不保证精确的执行时间，但保证“任务一定会被完成”。即使进程被杀死或设备重启，任务的入参和状态都会被序列化保存到内部数据库，重启后自动恢复。这个承诺非常可靠。
代码实战（Kotlin）
1. 添加依赖
// build.gradle.kts (module)
dependencies {
implementation("androidx.work:work-runtime-ktx:2.10.0")
}
2. 定义Worker
import android.content.Context
import android.util.Log
import androidx.work.Worker
import androidx.work.WorkerParameters
class SyncDataWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
override fun doWork(): Result {
val userId = inputData.getString("user_id") ?: return Result.failure()
Log.d("SyncDataWorker", "开始同步用户 $userId 的数据")
return try {
// 模拟网络同步耗时操作
Thread.sleep(2000)
Log.d("SyncDataWorker", "同步完成")
Result.success()
} catch (e: Exception) {
Log.e("SyncDataWorker", "同步失败", e)
Result.retry()
}
}
}
3. 单次任务：带约束的OneTimeWorkRequest
import androidx.work.*
val constraints = Constraints.Builder()
.setRequiredNetworkType(NetworkType.CONNECTED) // 仅在有网络时执行
.setRequiresBatteryNotLow(true) // 电池电量不低
.build()
val inputData = Data.Builder()
.putString("user_id", "42")
.build()
val uploadRequest = OneTimeWorkRequestBuilder()
.setConstraints(constraints)
.setInputData(inputData)
.setBackoffCriteria(BackoffPolicy.EXPONENTIAL, 10, TimeUnit.SECONDS)
.build()
WorkManager.getInstance(context).enqueue(uploadRequest)
注意，setBackoffCriteria指定了重试策略：指数退避，初始延迟10秒。只要前一次返回Result.retry()，WorkManager就会按照这个策略自动延后重试。
4. 定期任务：PeriodicWorkRequest
val syncRequest = PeriodicWorkRequestBuilder(1, TimeUnit.HOURS) // 每隔1小时执行一次
.setConstraints(Constraints.Builder()
.setRequiredNetworkType(NetworkType.CONNECTED)
.build())
.build()
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
"periodic_sync",
ExistingPeriodicWorkPolicy.KEEP, // 同名任务已存在则保留旧任务
syncRequest
)
需要注意，PeriodicWorkRequest的最小间隔是15分钟，低于此值会抛出异常。使用enqueueUniquePeriodicWork可以有效防止重复调度，确保后台任务唯一性。
5. 任务链：按顺序执行
val cleanDb = OneTimeWorkRequestBuilder().build()
val syncData = OneTimeWorkRequestBuilder().build()
val sendReport = OneTimeWorkRequestBuilder().build()
WorkManager.getInstance(context)
.beginWith(cleanDb)
.then(syncData)
.then(sendReport)
.enqueue()
链中任何一个Worker返回Result.failure()时，后续Worker都不会执行，整条链会直接终止。
6. 在ViewModel中观察任务状态
import androidx.lifecycle.ViewModel
import androidx.work.WorkInfo
import androidx.work.WorkManager
class UploadViewModel : ViewModel() {
fun observeWorkStatus(context: Context, workId: UUID) {
WorkManager.getInstance(context)
.getWorkInfoByIdLiveData(workId)
.observeForever { info: WorkInfo? ->
when (info?.state) {
WorkInfo.State.ENQUEUED -> println("任务已入队，等待执行")
WorkInfo.State.RUNNING -> println("任务正在运行")
WorkInfo.State.SUCCEEDED -> println("任务执行成功")
WorkInfo.State.FAILED -> println("任务执行失败")
WorkInfo.State.BLOCKED -> println("任务被阻塞（等待前置任务完成）")
WorkInfo.State.CANCELLED -> println("任务已被取消")
else -> { }
}
}
}
}
避坑指南
第一，不要把WorkManager当作AlarmManager使用。WorkManager的最小调度间隔是15分钟，且无法保证精确到秒的时机。如果需要精确闹钟或秒级周期性任务，请使用AlarmManager或Handler。
第二，doWork()在主线程之外执行，但普通Worker默认运行在后台线程池。如果改用CoroutineWorker（继承自ListenableWorker），doWork()会变成suspend函数，默认在Dispatchers.Default；普通Worker的doWork()在后台线程执行，不能直接操作UI。
第三，输入输出数据有大小限制。Data对象底层使用Bundle序列化，建议只传递简单的键值对。大数据应存储到文件或数据库，在Worker内部再读取。
第四，注意PeriodicWorkRequest的最小间隔。官方文档规定15分钟是硬性约束。如果确实需要5分钟执行一次，可以考虑用OneTimeWorkRequest配合递归调度，但要自己处理好幂等性。
第五，WorkManager的初始化。高版本Jetpack默认通过ContentProvider自动初始化。如果有自定义配置需求（例如自定义线程池），需要在AndroidManifest.xml中禁用自动初始化，改为手动初始化。
总结
WorkManager在Android后台任务体系中占据了一个明确的位置：它不负责实时推送，也不提供精确定时，但它将“可靠性”做到了极致。任务只要被入队，哪怕进程被杀死或设备重启，它也能帮你捡起来继续执行。
实际开发中，记住一个判断法则就够了：如果这个任务“用户离开页面后还需要继续做”，而且“必须做完不能丢失”，那就使用WorkManager。配合周期性调度和约束条件，它比手写Service省心得多，比AlarmManager可靠得多。真正掌握之后，你会发现编写后台逻辑的底气一下子足了不少。
