WorkManager中Kotlin异常未被捕获问题排查求助

核心原因分析 #

1. SDK34后台异常处理收紧
   Android 14（SDK34）对后台线程的未捕获异常处理机制做了严格限制，原有的隐式异常兜底逻辑被移除。如果WorkManager的Worker线程或RequestHelper的异步逻辑中抛出的异常未被显式捕获，会直接触发致命崩溃，且栈轨迹可能因为线程上下文隔离无法关联到调用起点。

2. GlobalScope协程的异常传播特性
   GlobalScope.launch启动的协程属于全局无绑定作用域，其内部未捕获的异常会直接交给系统UncaughtExceptionHandler处理，而非被launch块内的try-catch捕获——尤其是当asyncRequest内部包含挂起函数、跨线程切换（如withContext）或WorkManager的异步回调时，异常会脱离原协程上下文传播。

3. WorkManager与RequestHelper的上下文隔离
   WorkManager拥有独立的后台线程池，Worker的doWork()方法运行在该池内，与RequestHelper启动的协程/线程属于不同执行上下文。如果Worker内部抛出RequestHelper$ResponseCodeException，该异常不会回传到RequestHelper的try-catch块，而是直接被WorkManager的线程池处理（SDK34前可能被系统静默处理，现在触发崩溃）。

具体排查与修复步骤 #

1. 检查并修复Worker的异常处理

确保Worker内部捕获所有可能的异常，避免异常泄漏到系统线程池：

class MyWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
    override fun doWork(): Result {
        return try {
            // 原业务逻辑代码
            Result.success()
        } catch (e: RequestHelper.ResponseCodeException) {
            // 记录异常到Crashlytics或自定义日志
            FirebaseCrashlytics.getInstance().recordException(e)
            Result.failure()
        } catch (e: Exception) {
            // 兜底捕获所有异常
            Result.failure()
        }
    }
}

2. 替换GlobalScope为绑定式协程作用域

使用带SupervisorJob和自定义异常处理器的协程作用域，确保异常能被捕获：

// 定义绑定到组件生命周期的协程作用域（比如在Application或ViewModel中）
private val requestScope = CoroutineScope(Dispatchers.IO + SupervisorJob())
private val exceptionHandler = CoroutineExceptionHandler { _, throwable ->
    if (throwable is RequestHelper.ResponseCodeException) {
        // 自定义异常处理逻辑
    }
}

fun request() {
    requestScope.launch(exceptionHandler) {
        try {
            asyncRequest()
        } catch (e: RequestHelper.ResponseCodeException) {
            // 局部异常处理
        }
    }
}

3. 修正asyncRequest的异步等待逻辑

如果asyncRequest中包含等待WorkManager结果的逻辑，需用挂起函数显式等待并捕获异常：

suspend fun asyncRequest() {
    val workRequest = OneTimeWorkRequestBuilder<MyWorker>().build()
    WorkManager.getInstance(context).enqueue(workRequest)
    
    // 用挂起函数等待WorkManager执行结果
    val workInfo = WorkManager.getInstance(context)
        .getWorkInfoByIdLiveData(workRequest.id)
        .await()
    
    if (workInfo.state == WorkInfo.State.FAILED) {
        // 根据失败原因抛出异常（此时会被上层try-catch捕获）
        throw RequestHelper.ResponseCodeException("WorkManager任务执行失败")
    }
}

4. 验证Thread.start()的异常处理

如果尝试用普通线程替代协程，需确保线程内部的所有逻辑都被try-catch包裹：

fun request() {
    Thread {
        try {
            asyncRequest()
        } catch (e: RequestHelper.ResponseCodeException) {
            // 处理异常
        } catch (e: Exception) {
            // 兜底处理
        }
    }.start()
}

内容的提问来源于stack exchange，提问作者Developer-Mike