Android：使用WorkManager从Firebase Storage后台下载文件失败求助

我尝试使用WorkManager每2小时从Firebase Storage下载一个zip文件，以下是doWork函数的代码：

override fun doWork(): Result {
    val storage = FirebaseStorage.getInstance()
    val storageRef = storage.reference
    val pathReference = storageRef.child("customerdata.zip")
    Log.v("SysLog", "File download starting...") // This log can be seen in Logcat
    val localFile = File.createTempFile("customerdata", ".zip")
    pathReference.getFile(localFile).addOnSuccessListener {
        Log.v("SysLog", "File downloaded successfully")
    }.addOnFailureListener {
        Log.v("SysLog", "File download failed with error: ${it.localizedMessage}")
    }
    return Result.success()
}

目前doWork方法能正常被调用，但addOnSuccessListener从未触发，约10分钟后addOnFailureListener被调用，错误信息为"The operation retry limit has been exceeded"。该问题仅在应用被最小化且手机屏幕关闭时出现，前台运行时一切正常。请问我哪里操作有误？

问题根源分析 #

你踩了一个WorkManager新手常见的坑：doWork()是同步执行的方法，而你调用的Firebase Storage getFile()是异步回调式操作。当你直接在doWork()里启动异步下载就返回Result.success()时，WorkManager会认为任务已经完成，会立刻回收当前工作线程的资源——这就导致后台的异步下载任务被中途打断，反复重试几次后就触发了系统的重试次数超限错误。

而前台运行时，应用进程处于活跃状态，即使WorkManager的工作线程被回收，异步下载的线程可能还能依托应用进程完成，所以看起来一切正常；但屏幕关闭、应用后台时，系统对后台资源的限制更严格，被打断的任务根本没机会完成。

修复方案 #

核心思路是把异步下载改成同步阻塞执行，让doWork()直到下载完成（成功或失败）后再返回结果。可以用Firebase提供的Tasks.await()方法来实现：

override fun doWork(): Result {
    val storage = FirebaseStorage.getInstance()
    val storageRef = storage.reference
    val pathReference = storageRef.child("customerdata.zip")
    Log.v("SysLog", "File download starting...")

    return try {
        val localFile = File.createTempFile("customerdata", ".zip")
        // 同步等待下载任务完成，阻塞当前线程直到结果返回
        Tasks.await(pathReference.getFile(localFile))
        Log.v("SysLog", "File downloaded successfully")
        Result.success()
    } catch (e: Exception) {
        Log.v("SysLog", "File download failed with error: ${e.localizedMessage}")
        // 根据业务需求选择：是重试还是标记失败
        Result.retry() // 若需要重试用这个，否则用Result.failure()
    }
}

额外优化建议 #

1. 添加网络约束：下载依赖网络，给WorkRequest加上网络约束，避免在无网时触发任务，减少无效重试：

   val constraints = Constraints.Builder()
       .setRequiredNetworkType(NetworkType.CONNECTED)
       .build()
   
   val downloadWorkRequest = PeriodicWorkRequestBuilder<YourWorkerClass>(2, TimeUnit.HOURS)
       .setConstraints(constraints)
       .build()
   

2. 处理厂商后台限制：部分国产手机的电池优化会强制杀死后台任务，你可以引导用户在应用设置中关闭“电池优化”；如果下载文件较大，也可以给Worker设置ForegroundInfo，将任务提升为前台任务，降低被系统杀死的概率。
3. 自定义重试策略：默认的重试是指数退避，你可以根据需求改成线性退避，调整重试间隔：

   val downloadWorkRequest = PeriodicWorkRequestBuilder<YourWorkerClass>(2, TimeUnit.HOURS)
       .setConstraints(constraints)
       .setBackoffCriteria(BackoffPolicy.LINEAR, 10, TimeUnit.MINUTES)
       .build()
   

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