Android后台Periodic Work Manager在小米等机型停止运行问题求解

• 核心原因是国产安卓定制系统（小米、Arma等）的后台活动限制策略与原生AOSP（Google Pixel搭载的系统）存在差异：原生系统对符合规范的WorkManager任务无额外限制，而小米的神隐模式、Arma的后台管控机制会在应用被关闭后将其标记为「非活跃状态」，冻结所有后台调度任务，仅在应用被重新打开时才会解冻恢复任务执行。
• 额外可能原因：未申请后台运行必要权限、任务约束配置不匹配、Worker执行异常被系统标记为高风险任务从而被限制调度。

系统适配侧（最有效） #

• 引导用户手动开启应用权限：在应用设置页增加指引，跳转到系统应用信息配置页，让用户开启「自启动权限」、关闭「电池优化」、将应用后台活动策略设置为「无限制」；针对小米设备还需要引导用户将应用加入最近任务锁，避免划掉最近任务时应用被强行停止。
• 在AndroidManifest.xml中声明必要权限：

<!-- 重启后保留WorkManager任务 -->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<!-- 申请忽略电池优化权限 -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

如果需要可主动申请忽略电池优化权限，注意该权限上架Google Play时需要补充合规说明。

代码优化侧 #

• 显式配置任务约束：你当前的代码未声明任务运行约束，若上报需要网络需要显式指定网络条件，避免无网时任务触发失败被系统限流，示例如下：

val constraints = Constraints.Builder()
    .setRequiredNetworkType(NetworkType.CONNECTED)
    .build()
val request = PeriodicWorkRequest.Builder(
    BackgroundSyncWorker::class.java,
    period,
    TimeUnit.MINUTES,
    1,
    TimeUnit.MINUTES
).addTag(tag)
 .setConstraints(constraints)
 .build()

• 提升任务优先级：给任务配置加急属性，提高系统调度优先级：

.setExpedited(OutOfQuotaPolicy.RUN_AS_NON_EXPEDITED_WORK_REQUEST)

• 适配国内推送通道：单纯依赖周期任务无法100%保证在国产系统上的运行可靠性，可接入小米推送、OPPO推送等对应厂商的推送通道，由服务端发送透传消息唤醒应用执行上报，大幅提升上报成功率。
• 显式配置重试策略：避免Worker执行异常后被系统限制调度：

.setBackoffCriteria(BackoffPolicy.LINEAR, 10, TimeUnit.MINUTES)

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