PeriodicWorkRequestBuilder仅执行一次，下次调度时间异常求助

我尝试配置PeriodicWorkRequestBuilder，使其每天早上5点从服务器下载数据，但发现Worker仅运行一次后就不再执行。以下是初始配置代码：

private val uniqueWorkName = MediaDownloadWorker::class.java.simpleName

private const val WORKER_TAG_OUTPUT = "media_download_worker"
const val FOREGROUND_NOTIFICATION_ID = 20240212
const val DOWNLOAD_NOTIFICATION_CHANNEL_ID = "download_message_notifications"

/** Enqueues a new worker to download media only if not enqueued already. */
fun enqueue(context: Context) {
    val manager = WorkManager.getInstance(context)

    val currentDate = Calendar.getInstance()
    val dueDate = Calendar.getInstance()
    // Set Execution around 05:00:00 AM.
    dueDate.set(Calendar.HOUR_OF_DAY, 5)
    dueDate.set(Calendar.MINUTE, 0)
    dueDate.set(Calendar.SECOND, 0)

    if (dueDate.before(currentDate)) {
        dueDate.add(Calendar.HOUR_OF_DAY, 24)
    }
    val timeDiff = dueDate.timeInMillis - currentDate.timeInMillis

    val constraints =
        Constraints.Builder()
            .setRequiredNetworkType(NetworkType.UNMETERED)
            .setRequiresBatteryNotLow(true)
            .build()
    val dailyWorkRequest =
        PeriodicWorkRequestBuilder<MediaDownloadWorker>(1, TimeUnit.DAYS)
            .setConstraints(constraints)
            .setInitialDelay(timeDiff, TimeUnit.MILLISECONDS)
            .addTag(WORKER_TAG_OUTPUT)
            .build()

    manager.enqueueUniquePeriodicWork(
        "MediaDownloadWorker", ExistingPeriodicWorkPolicy.KEEP, dailyWorkRequest)
}

Worker继承自CoroutineWorker：

class MediaDownloadWorker(private val context: Context, workerParameters: WorkerParameters) :
    CoroutineWorker(context, workerParameters) {

内部使用androidx.media3.exoplayer.offline.DownloadManager处理下载请求：

val downloadRequest =
        DownloadRequest.Builder(Util.getUtf8Bytes(mediaUrl).toString(), Uri.parse(mediaUrl))
            .setMimeType(mimeType)
            .build()
    downloadManager.addDownload(downloadRequest)

为测试问题，我移除初始延迟并将间隔设为15分钟，观察到Worker首次运行前nextScheduleTimeMillis正常，但运行后该值变为9223372036854775807（对应2066年左右）。我们用相同方式实现的Widget更新Worker运行正常，请问可能是什么原因导致此问题？

1. Worker返回结果异常 #

CoroutineWorker的执行结果直接决定后续调度逻辑：

• 如果doWork()方法未明确返回Result.success()，或返回Result.failure()/重试次数耗尽后的失败结果，WorkManager会判定任务无法持续执行，将后续调度时间设为最大值。
• 检查doWork()逻辑：确保下载流程完成后必须返回Result.success()，即使出现非致命异常，也不要返回失败结果（除非业务明确要求终止周期任务）。

2. 约束条件长期无法满足 #

你的Work设置了两个严格约束：

• NetworkType.UNMETERED：仅允许Wi-Fi环境下运行
• RequiresBatteryNotLow(true)：电池不能处于低电量状态
  如果设备长期处于移动数据或低电量状态，WorkManager会不断推迟任务，最终触发"无限延迟"机制。可以：
• 临时移除约束测试，验证周期任务是否正常执行；
• 若业务允许，放宽约束（比如改为NetworkType.CONNECTED），或通过setBackoffCriteria()配置合理的重试策略，避免无限推迟。

3. ExoPlayer DownloadManager的生命周期干扰 #

你在Worker内部使用的DownloadManager可能干扰Worker的正常结束：

• DownloadManager.addDownload()是异步操作，若Worker在下载完成前就结束，可能导致结果返回异常；
• 检查是否存在DownloadManager的回调阻塞Worker线程，或Worker被系统提前杀死的情况；
• 建议在Worker中仅触发下载请求，不等待下载完成，直接返回Result.success()，让DownloadManager自行处理后续下载流程。

4. 唯一任务策略冲突 #

使用ExistingPeriodicWorkPolicy.KEEP时，若之前存在旧的周期任务配置（比如间隔、约束不同），新请求不会覆盖旧任务。可以：

• 改用ExistingPeriodicWorkPolicy.REPLACE，确保新配置生效；
• 测试前调用WorkManager.getInstance(context).cancelUniqueWork("MediaDownloadWorker")清除旧任务，再重新入队。

5. 系统后台限制 #

部分厂商的系统电池优化或后台管控会阻止Worker周期性运行：

• 将应用加入电池优化白名单；
• 确保应用拥有POST_NOTIFICATIONS权限，Android 12+的长期后台任务需要前台通知，否则会被系统限制。

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