使用enqueueUniquePeriodicWork入队的Worker类停止工作，求原因与排查方法

我实现了一个继承自Worker的类：

public class UpdatePushRegistration extends Worker

通过以下代码将其作为周期性任务入队：

PeriodicWorkRequest myWorkRequest = new PeriodicWorkRequest.Builder(UpdatePushRegistration.class, 20, TimeUnit.MINUTES)
.build();

WorkManager.getInstance(getApplicationContext()).enqueueUniquePeriodicWork("UpdatePushNotification", ExistingPeriodicWorkPolicy.CANCEL_AND_REENQUEUE,myWorkRequest);

调试时（笔记本保持开机）任务运行正常，但在手机上（无论是直接安装APK还是应用商店发布版本），任务仅运行数次（有时仅2次）后就停止了（我通过云端日志确认），已在两款不同机型测试。请问可能的原因是什么？该如何排查？

可能原因 #

• 系统电池优化/后台限制：多数安卓厂商会对后台任务做严格管控，当应用处于后台、屏幕熄灭或设备低电量时，会暂停甚至取消周期性任务。比如小米的「神隐模式」、华为的「后台管控」、三星的「电池优化」等，都会直接影响WorkManager的调度逻辑。
• Worker执行异常未处理：如果UpdatePushRegistration的doWork()方法抛出未捕获异常，或者返回Result.failure()且未配置重试策略，WorkManager会停止后续的周期性调度。
• 高频任务触发系统打压：20分钟的间隔属于较频繁的后台任务，部分厂商系统会限制高频任务的执行，避免过度消耗电量。
• 应用被系统/用户终止：系统内存不足时会优先杀死后台应用，连带取消其所有WorkManager任务；用户手动划掉应用后，部分厂商会直接终止应用的所有后台进程。
• WorkManager版本兼容性问题：不同版本的WorkManager在特定安卓版本或厂商系统上可能存在调度逻辑的兼容性bug。

排查步骤 #

• 检查系统电池与后台权限设置
  • 进入手机设置的「电池优化」选项，将目标应用设置为「不优化」；同时开启厂商专属的后台权限，比如小米的「自启动管理」、华为的「允许后台活动」。
• 排查Worker执行逻辑
  • 在doWork()中添加完整的异常捕获与日志输出，确保所有异常都被处理，并返回合适的Result：

    @NonNull
    @Override
    public Result doWork() {
        try {
            // 业务逻辑代码
            Log.d("UpdatePushReg", "任务执行完成");
            return Result.success();
        } catch (Exception e) {
            Log.e("UpdatePushReg", "任务执行异常", e);
            // 允许重试，避免单次失败终止周期调度
            return Result.retry();
        }
    }
    

  • 确认未在代码中返回Result.failure()，该返回值会直接终止后续周期性任务。
• 调整任务间隔测试
  • 将周期调整为1小时或更长，观察任务是否能持续执行，判断是否是高频任务触发了系统限制。
• 监控应用存活状态
  • 使用adb shell dumpsys activity processes命令查看应用进程是否被系统杀死，区分是后台限制还是进程被杀导致的任务终止。
  • 测试应用在前台时任务的执行情况，确认问题是否仅出现在后台场景。
• 查看WorkManager调度日志
  • 使用adb logcat -s WorkManager命令抓取WorkManager的官方日志，查找任务被取消、延迟、失败的具体原因。
• 验证WorkManager版本
  • 确保项目依赖的是最新稳定版WorkManager，避免已知的兼容性问题。

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