Android PeriodicWorkRequest运行一段时间后停止的原因与排查

我开发了一款Android应用，通过Worker将手机电池电量上报至远程服务器。该Worker在主Activity的OnCreate方法中注册，代码如下：

PeriodicWorkRequest pwr = new PeriodicWorkRequest.Builder(BatteryReportWorker.class,
        15, TimeUnit.MINUTES).setConstraints(
                new Constraints.Builder()
                        .setRequiredNetworkType(NetworkType.CONNECTED)
                        .build())
        .build();
workManager.enqueueUniquePeriodicWork("BatteryReportWorker", ExistingPeriodicWorkPolicy.REPLACE, pwr);

起初运行正常，但不到一天时间Worker就停止向后端上报数据。仅打开应用无需操作，Worker就会立即恢复并上报数据，推测是Android系统不再执行该周期性任务。请问Android为何会停止运行周期性工作请求？该如何排查WorkManager停止执行Worker的原因？

已排查事项：

• 并非三星电池休眠问题，Google Pixel手机也出现此情况
• 并非应用暂停功能导致，因为停止时间不到一天

可能的原因 #

1. 系统后台限制：Android 8.0及以上版本对后台任务管控严格，应用进入后台长时间未活跃时，系统会限制其后台执行能力，包括暂停周期性Work任务。哪怕是Pixel设备，原生系统也会基于电池优化策略，暂停非必要的后台任务。
2. Work任务意外终止：应用进程被系统杀死、任务约束长期不满足（比如长时间断网后系统未重试）、任务执行时抛出未处理异常，都可能导致任务被标记为失败或取消，进而停止调度。
3. 任务注册逻辑缺陷：仅在主Activity的OnCreate中注册任务，若应用被杀死后重启但主Activity未启动，任务不会重新注册；另外每次启动都用ExistingPeriodicWorkPolicy.REPLACE替换任务，可能打乱调度逻辑。
4. 原生电池优化影响：Android自带的App Standby、Doze模式等电池优化策略，会在用户长时间不交互应用时，拉长甚至暂停周期性任务的执行间隔。

排查步骤 #

1. 查看WorkManager日志
   • 用adb命令抓取WorkManager专属日志：adb logcat -s WorkManager，重点关注任务的调度、执行、取消或失败记录，比如是否有系统取消任务的日志，或是任务执行时的异常信息。
2. 监控任务状态
   • 在应用中通过WorkManager.getWorkInfosForUniqueWorkLiveData("BatteryReportWorker")监听任务状态，确认任务是处于ENQUEUED、RUNNING，还是CANCELLED、FAILED状态，判断任务是否被终止。
3. 验证约束条件有效性
   • 检查网络约束是否长期不满足：比如设备长时间断网，WorkManager会暂停任务直到约束满足，但部分场景下可能出现系统无法恢复调度的情况，可暂时移除网络约束测试任务是否能持续执行。
4. 排除电池优化影响
   • 手动将应用加入电池优化白名单（路径：设置-电池-电池优化-找到对应应用设置为“不优化”），观察任务是否能正常持续执行，以此确认是否是系统电池优化导致的问题。
5. 优化任务注册逻辑
   • 将任务注册逻辑移至Application类的onCreate方法中，确保应用启动时无论主Activity是否打开都能完成任务注册；同时考虑改用ExistingPeriodicWorkPolicy.KEEP，避免每次启动替换任务引发调度冲突。
6. 检查应用进程状态
   • 用adb shell dumpsys activity processes查看应用进程是否频繁被系统杀死，若进程经常被终止，说明应用可能因内存不足或系统后台清理策略被管控，导致WorkManager无法正常调度任务。

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