使用Kotlin WorkManager实现15分钟周期POST请求并支持重启持久化

需求说明 #

• 任务需携带JSON负载发起POST API请求；
• 每15分钟执行一次；
• 设备重启后无需用户交互或重启应用即可持续执行。

我的实现代码 #

class ApiWorker(context: Context, workerParams: WorkerParameters) : Worker(context, workerParams) {
    override fun doWork(): Result {
        return try {
            val client = OkHttpClient()
            val jsonObject = JSONObject().apply {
                put("key1", "value1")
                put("key2", "value2")
            }
            val requestBody = RequestBody.create(
                "application/json".toMediaTypeOrNull(),
                jsonObject.toString()
            )

            val request = Request.Builder()
                .url("https://yourapiendpoint.com/yourpostendpoint")
                .post(requestBody)
                .build()

            val response = client.newCall(request).execute()
            if (response.isSuccessful) {
                Result.success()
            } else {
                Result.retry()
            }
        } catch (e: Exception) {
            Result.retry()
        }
    }
}

fun scheduleApiWorker(context: Context) {
    val workRequest = PeriodicWorkRequestBuilder<ApiWorker>(15, TimeUnit.MINUTES)
        .setConstraints(
            Constraints.Builder()
                .setRequiredNetworkType(NetworkType.CONNECTED)
                .setRequiresBatteryNotLow(true)
                .build()
        )
        .build()

    WorkManager.getInstance(context).enqueueUniquePeriodicWork(
        "ApiWorker",
        ExistingPeriodicWorkPolicy.KEEP,
        workRequest
    )
}

实现分析与结论 #

你的实现基本满足核心需求，但有几个关键细节需要明确和优化：

1. 设备重启后的任务持续性 #

WorkManager会自动处理设备重启后的任务恢复（Android 7.0+依赖系统JobScheduler，低版本依赖AlarmManager+BroadcastReceiver），只要应用未被用户强制停止，重启后任务会自动重新调度，无需额外配置。但如果用户手动停止应用，所有WorkManager任务会被取消，重启设备也无法恢复。

2. 15分钟周期的实际执行情况 #

你设置的15, TimeUnit.MINUTES是周期的最短间隔，但WorkManager为了优化电池消耗，可能会调整实际执行时间（比如合并任务批次）。如果需要严格的15分钟间隔，WorkManager并非最优选择——它更适合容忍一定延迟的周期性任务。若必须严格准时，可考虑结合AlarmManager，但会增加电池消耗。

3. 代码细节优化建议 #

• 避免每次doWork()创建新的OkHttpClient实例，建议复用单例客户端，减少资源消耗；
• RequestBody.create已被废弃，建议改用RequestBody.create("application/json".toMediaType(), jsonObject.toString())（需确保引入OkHttp依赖，使toMediaType()可用）；
• Result.retry()默认采用指数退避策略，若需要固定间隔重试，可在PeriodicWorkRequestBuilder中添加setBackoffCriteria(BackoffPolicy.LINEAR, 15, TimeUnit.MINUTES)。

4. 任务唯一性处理 #

使用enqueueUniquePeriodicWork并指定ExistingPeriodicWorkPolicy.KEEP，可以避免重复调度相同任务，这部分实现是正确的。

总结 #

你的代码可以实现设备重启后自动恢复的周期性POST任务，但实际执行间隔可能存在轻微延迟。如果对时间精度要求不高，该实现完全可用；若需严格准时执行，则需考虑其他方案。

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