协程未使用配置的Log4j日志器：差异原因与最优解法

1. 协程线程上下文与异常传播差异 #

• 用CoroutineScope(Dispatchers.Default).launch启动的协程属于独立后台协程，运行在DefaultDispatcher的工作线程上。这些线程未绑定Spring的请求上下文和日志上下文，当协程抛出未捕获异常时，协程调度器的默认处理逻辑会直接将异常打印到stderr——因为该线程不受Spring异常拦截体系管控。
• runBlocking会阻塞当前Tomcat请求线程（如nio-8080-exec-1），协程内的异常会直接传播到runBlocking的调用线程。这个线程处于Spring请求上下文范围内，Spring的DispatcherServlet会捕获异常，再通过配置好的Log4j日志器输出，这是Spring Web的标准异常处理流程。

2. 协程默认异常处理行为 #

Kotlin协程中，launch启动的协程若未指定CoroutineExceptionHandler，未捕获异常会被调度器默认处理器处理：对于DefaultDispatcher这类线程池调度器，默认行为就是输出到标准错误流。而runBlocking作为阻塞世界与协程世界的桥接工具，会将协程异常直接抛到调用线程，交由调用线程的异常处理机制（此处为Spring异常拦截）接管。

在Spring Boot环境中处理协程异常，优先使用Spring原生支持的协程方式，避免手动创建独立CoroutineScope：

方案1：使用suspend控制器方法（最推荐） #

Spring Boot 2.2+原生支持suspend类型的控制器方法，协程会运行在Spring管理的上下文里，异常自动被Spring异常处理机制捕获并输出到Log4j：

@RestController
class SoDemoController {
    @GetMapping("/demo")
    suspend fun demo(): ResponseEntity<String> {
        async {
            delay(1000)
            error("some error happens")
        }.await()
        return ResponseEntity.ok("done")
    }
}

方案2：使用Spring管理的CoroutineScope #

若需手动创建协程，注入Spring提供的WebCoroutineScope，它会自动绑定请求上下文和异常处理逻辑：

@RestController
class SoDemoController {
    private val coroutineScope = WebCoroutineScope(Dispatchers.Default)

    @GetMapping("/demo")
    fun demo(): ResponseEntity<String> {
        coroutineScope.launch {
            async {
                delay(1000)
                error("some error happens")
            }.await()
        }
        return ResponseEntity.ok("done")
    }
}

方案3：自定义CoroutineExceptionHandler #

如果必须使用自定义CoroutineScope，可添加自定义异常处理器，手动将异常输出到Log4j：

private val log = LoggerFactory.getLogger(SoDemoController::class.java)
private val exceptionHandler = CoroutineExceptionHandler { _, throwable ->
    log.error("Coroutine execution failed", throwable)
}

@RestController
class SoDemoController {
    @GetMapping("/demo")
    fun demo(): ResponseEntity<String> {
        CoroutineScope(Dispatchers.Default + exceptionHandler).launch {
            async {
                delay(1000)
                error("some error happens")
            }.await()
        }
        return ResponseEntity.ok("done")
    }
}

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