原生移动开发 / 系统课时

处理失败重试与退避

处理失败重试与退避

本篇解决后台任务遇到网络波动、临时服务异常时“应该直接失败,还是稍后再试”的问题。你将区分 Result.success()、Result.failure() 和 Result.retry(),并配置退避策略,让临时故障不会立即形成高频重试。

学习目标

  • 能根据任务结果选择成功、失败或重试
  • 能配置线性或指数退避策略
  • 能区分临时异常与不可恢复错误,避免错误地无限重试

三种结果分别代表什么

Worker 最终通过 Result 告诉 WorkManager 这次执行应该如何结束。Result.success() 表示任务完成;Result.failure() 表示任务已经执行但无法通过再次尝试解决;Result.retry() 表示当前失败更像临时问题,应该按既定退避策略再次调度。

WorkManager 成功、失败与重试状态流转

可以把判断原则简单理解为:重试是等待条件变化,失败是等待也没有意义。例如一次 HTTP 请求因为暂时断网失败,通常适合返回 Result.retry();如果服务端明确返回请求参数非法,则继续请求往往只会重复失败,更适合返回 Result.failure()。

配置退避策略

WorkManager 支持线性和指数两种退避方式。指数退避会让连续失败后的等待时间逐步拉长,适合网络抖动或临时服务不可用场景,可以减少短时间内重复请求带来的压力。设置退避时,最短退避时间不能低于 WorkManager 允许的最小值。

kotlin
import androidx.work.BackoffPolicy
import androidx.work.CoroutineWorker
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.Result
import androidx.work.WorkerParameters
import java.util.concurrent.TimeUnit
import android.content.Context

class SyncWorker(
    appContext: Context,
    workerParams: WorkerParameters
) : CoroutineWorker(appContext, workerParams) {

    override suspend fun doWork(): Result {
        val succeeded = performSync()

        return when {
            succeeded -> Result.success()
            shouldRetry() -> Result.retry()
            else -> Result.failure()
        }
    }

    private suspend fun performSync(): Boolean {
        // 这里代表业务同步逻辑;真实项目中应由网络或数据库操作返回结果。
        return true
    }

    private fun shouldRetry(): Boolean = true
}

val request = OneTimeWorkRequestBuilder<SyncWorker>()
    .setBackoffCriteria(
        BackoffPolicy.EXPONENTIAL,
        10,
        TimeUnit.SECONDS
    )
    .build()

预期结果

text
创建成功后,SyncWorker 返回 Result.retry() 时不会立即连续执行,而是按照 EXPONENTIAL 退避策略等待后再次调度;返回 success 或 failure 时分别进入对应的完成状态。

正确区分临时错误与永久错误

重试策略真正重要的不是“失败就重试”,而是判断失败是否可能自行恢复。常见临时错误包括网络暂时不可用、服务端短时不可用、连接超时等;常见不可恢复错误包括请求参数非法、认证配置错误、业务数据本身不满足约束等。

可以把业务异常先归类,再决定返回值:

异常类型 常见处理 原因
网络暂时断开 Result.retry() 条件可能恢复
请求超时 Result.retry() 下一次可能成功
服务端临时不可用 Result.retry() 适合等待后再试
参数格式错误 Result.failure() 重试不会改变输入
本地配置错误 Result.failure() 需要人工或代码修复

不要让重试掩盖真实故障

退避只能降低重试频率,不能修复永久错误。如果一个任务每次都因为同一参数校验失败而返回 Result.retry(),它可能长期占用调度资源,却没有任何成功机会。因此,重试条件应该尽量建立在明确的可恢复信号上。

最终可以用一个简单规则检查实现:任务真正完成就返回 success,明确无法恢复就返回 failure,只把可能因等待而恢复的异常交给 retry,再用退避控制下一次尝试的时间间隔。这样 WorkManager 才能承担可靠调度,而不是变成快速重复失败的循环器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理失败重试与退避

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通