原生移动开发 / 系统课时
定位 WorkManager 未执行
定位 WorkManager 未执行
WorkManager 任务“没有执行”时,最有效的办法不是立刻重新 enqueue(),而是先看任务状态,再核对 Constraints、唯一任务策略、重试状态和系统调度。只要按这条顺序排查,就能区分“尚未满足运行条件”和“任务其实已经失败或被替换”。
学习目标
- 能通过
WorkInfo判断任务是在排队、运行、成功、失败还是取消。 - 能定位 Constraints、唯一任务策略和
Result.retry()导致的“看起来没执行”。 - 能用系统调度信息验证 WorkManager 是否已经把任务交给系统执行。
先看 WorkInfo,而不是看业务日志
WorkManager 会持久化任务状态,排障的第一现场应该是 WorkInfo。常见状态包括 ENQUEUED、RUNNING、SUCCEEDED、FAILED 和 CANCELLED。其中 ENQUEUED 很重要:它通常说明任务已经入队,但当前还没满足执行条件或正在等待调度,而不等于任务丢失。
片段示例:下面代码放在已有的 Android Activity、ViewModel 或其他可访问 WorkManager 的上下文中执行,用于查询指定任务。
val info = WorkManager
.getInstance(context)
.getWorkInfoById(workId)
.get()
println("state=${info?.state}")
println("runAttemptCount=${info?.runAttemptCount}")预期结果
state=ENQUEUED
runAttemptCount=0实际状态可能是 RUNNING、SUCCEEDED、FAILED 或 CANCELLED。getWorkInfoById() 可按任务 UUID 获取对应的 WorkInfo。([Android Developers][3])
检查 Constraints 是否把任务挡住
如果状态长期停留在 ENQUEUED,优先检查 Constraints。常见条件包括网络、电量、充电、存储空间等;只要有一个必要条件未满足,Worker 就不会按预期启动。
例如,下面是一个需要网络的请求:
val request = OneTimeWorkRequestBuilder<SyncWorker>()
.setConstraints(
Constraints.Builder()
.setRequiredNetworkType(NetworkType.CONNECTED)
.build()
)
.build()预期结果
任务被入队后,只有设备满足 CONNECTED 网络条件时,SyncWorker 才具备运行资格。排障时不要只看“手机明明有网”。还要确认 WorkManager 看到的约束是否已满足,以及设备当前是否受到后台限制、待机桶或配额影响。官方调试输出会同时列出 required、satisfied、unsatisfied constraints,以及任务的 Ready 状态。([Android Developers][4])

检查唯一任务是否把旧任务替换掉
唯一任务适合避免重复同步,但策略本身也可能造成“新任务没跑”。例如 KEEP 在已有同名未完成任务时,会直接忽略新任务;REPLACE 则会取消并删除已有的同名未完成任务,再插入新任务。([Android Developers][5])
排障时把“唯一名称”和“ExistingWorkPolicy”一起记录。尤其是用户连续点击同步按钮时,不能只看到最后一次 enqueueUniqueWork(),还要确认前面的同名任务是否仍处于 pending 状态。
检查重试和系统调度
Worker 的返回值也决定下一步:Result.success() 表示完成,Result.failure() 表示最终失败,Result.retry() 表示稍后按重试策略再次执行。([Android Developers][6]) 因此看到“Worker 没有继续跑”时,要先判断它是尚未执行,还是已经执行过一次并进入退避等待。
最后再查看系统侧调度信息:
adb shell dumpsys jobscheduler预期输出
com.example.app ... androidx.work.impl.background.systemjob.SystemJobService
...实际输出会包含当前设备上的 JobScheduler 任务;重点寻找属于应用包名、服务组件为 androidx.work.impl.background.systemjob.SystemJobService 的记录,并结合 required、satisfied、unsatisfied constraints 判断系统是否已经收到任务。([Android Developers][4])
排查完成后,正确的修复通常只有一种:让任务重新满足它真实需要的条件,并确认唯一任务策略和 Worker 返回值符合业务语义,而不是靠重复入队“碰运气”。