原生移动开发 / 系统课时

定位 WorkManager 未执行

定位 WorkManager 未执行

WorkManager 任务“没有执行”时,最有效的办法不是立刻重新 enqueue(),而是先看任务状态,再核对 Constraints、唯一任务策略、重试状态和系统调度。只要按这条顺序排查,就能区分“尚未满足运行条件”和“任务其实已经失败或被替换”。

学习目标

  • 能通过 WorkInfo 判断任务是在排队、运行、成功、失败还是取消。
  • 能定位 Constraints、唯一任务策略和 Result.retry() 导致的“看起来没执行”。
  • 能用系统调度信息验证 WorkManager 是否已经把任务交给系统执行。

先看 WorkInfo,而不是看业务日志

WorkManager 会持久化任务状态,排障的第一现场应该是 WorkInfo。常见状态包括 ENQUEUED、RUNNING、SUCCEEDED、FAILED 和 CANCELLED。其中 ENQUEUED 很重要:它通常说明任务已经入队,但当前还没满足执行条件或正在等待调度,而不等于任务丢失。

片段示例:下面代码放在已有的 Android Activity、ViewModel 或其他可访问 WorkManager 的上下文中执行,用于查询指定任务。

kotlin
val info = WorkManager
    .getInstance(context)
    .getWorkInfoById(workId)
    .get()

println("state=${info?.state}")
println("runAttemptCount=${info?.runAttemptCount}")

预期结果

text
state=ENQUEUED
runAttemptCount=0

实际状态可能是 RUNNING、SUCCEEDED、FAILED 或 CANCELLED。getWorkInfoById() 可按任务 UUID 获取对应的 WorkInfo。([Android Developers][3])

检查 Constraints 是否把任务挡住

如果状态长期停留在 ENQUEUED,优先检查 Constraints。常见条件包括网络、电量、充电、存储空间等;只要有一个必要条件未满足,Worker 就不会按预期启动。

例如,下面是一个需要网络的请求:

kotlin
val request = OneTimeWorkRequestBuilder<SyncWorker>()
    .setConstraints(
        Constraints.Builder()
            .setRequiredNetworkType(NetworkType.CONNECTED)
            .build()
    )
    .build()

预期结果

text
任务被入队后,只有设备满足 CONNECTED 网络条件时,SyncWorker 才具备运行资格。

排障时不要只看“手机明明有网”。还要确认 WorkManager 看到的约束是否已满足,以及设备当前是否受到后台限制、待机桶或配额影响。官方调试输出会同时列出 required、satisfied、unsatisfied constraints,以及任务的 Ready 状态。([Android Developers][4])

WorkManager 未执行定位路径

检查唯一任务是否把旧任务替换掉

唯一任务适合避免重复同步,但策略本身也可能造成“新任务没跑”。例如 KEEP 在已有同名未完成任务时,会直接忽略新任务;REPLACE 则会取消并删除已有的同名未完成任务,再插入新任务。([Android Developers][5])

排障时把“唯一名称”和“ExistingWorkPolicy”一起记录。尤其是用户连续点击同步按钮时,不能只看到最后一次 enqueueUniqueWork(),还要确认前面的同名任务是否仍处于 pending 状态。

检查重试和系统调度

Worker 的返回值也决定下一步:Result.success() 表示完成,Result.failure() 表示最终失败,Result.retry() 表示稍后按重试策略再次执行。([Android Developers][6]) 因此看到“Worker 没有继续跑”时,要先判断它是尚未执行,还是已经执行过一次并进入退避等待。

最后再查看系统侧调度信息:

bash
adb shell dumpsys jobscheduler

预期输出

text
com.example.app ... androidx.work.impl.background.systemjob.SystemJobService
...

实际输出会包含当前设备上的 JobScheduler 任务;重点寻找属于应用包名、服务组件为 androidx.work.impl.background.systemjob.SystemJobService 的记录,并结合 required、satisfied、unsatisfied constraints 判断系统是否已经收到任务。([Android Developers][4])

排查完成后,正确的修复通常只有一种:让任务重新满足它真实需要的条件,并确认唯一任务策略和 Worker 返回值符合业务语义,而不是靠重复入队“碰运气”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位 WorkManager 未执行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通