spring boot 全局异常处理无法直接捕获 rxjava 调度线程抛出的异常,因为 rxjava 的异步执行脱离了 spring mvc 的 dispatcherservlet 请求链路。要解决这个问题,必须在 observable 或 single 的构建链中通过 doonerror、subscribeon 配合自定义 scheduler 或在主线程订阅时统一处理来拦截异常。具体做法是在调用链末端使用 subscribe 并传入 consumer 错误处理器,或者在异步任务提交前将异常包装为 spring 可识别的类型。

为什么 @ControllerAdvice 抓不到 RxJava 异常
@ControllerAdvice 依赖 Spring MVC 的请求分发机制,而 RxJava 默认在后台线程池执行,异常发生在控制器方法返回之后或完全不同的线程上下文中,因此不会触发 Spring 的全局异常处理器。必须显式地在 RxJava 的订阅阶段处理错误,否则异常会被 RxJava 的 OnErrorNotImplementedException 吞掉或导致程序崩溃。

import io.reactivex.rxjava3.core.Observable;
import io.reactivex.rxjava3.schedulers.Schedulers;
public class RxExceptionHandlerDemo {
public static void main(String[] args) {
Observable.just(1)
.map(i -> { throw new RuntimeException("Simulated Error"); })
.subscribeOn(Schedulers.io())
.subscribe(
result -> System.out.println("Success: " + result),
error -> System.err.println("Caught in Rx: " + error.getMessage())
);
// 等待异步执行完成
try { Thread.sleep(100); } catch (InterruptedException e) {}
}
}
上述代码展示了最基础的 RxJava 3 异常捕获方式。当 map 操作符抛出异常时,它不会传播到 Java 主线程,而是直接进入 subscribe 的第二个参数(错误消费者)。如果省略第二个参数,RxJava 会打印堆栈跟踪并终止该订阅流。这种处理方式与 Spring 无关,是 RxJava 内部的契约。
如何将 RxJava 异常转换为 Spring 可处理的异常
为了让 Spring Boot 的全局异常处理生效,需要将 RxJava 的异常“桥接”回同步上下文。常见做法是在控制器中调用 RxJava 流程时,使用 blockingSubscribe 或在主线程进行阻塞获取,这样异常就会以同步方式抛出,从而被 @ControllerAdvice 捕获。另一种高级做法是使用自定义的 Scheduler 包装器,在调度前检查并转换异常,但这通常过于复杂且容易引入死锁风险。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import io.reactivex.rxjava3.core.Single;
@RestController
public class DemoController {
@GetMapping("/test")
public String testSync() {
return Single.fromCallable(() -> {
// 模拟耗时或可能失败的操作
if (true) throw new RuntimeException("DB Error");
return "OK";
}).blockingGet(); // 关键:阻塞获取,异常转为同步抛出
}
}
在 DemoController 中,blockingGet() 强制在主线程等待结果。如果 fromCallable 内部抛出异常,blockingGet 会将其包装或直接抛出(取决于 RxJava 版本和配置),此时异常处于 Spring MVC 的请求处理线程中,@ControllerAdvice 即可正常拦截。注意,这种方式牺牲了 RxJava 的非阻塞优势,仅适用于必须与 Spring 异常体系集成的场景。
基于 blockingGet 抛出异常时的具体类型问题
当使用 blockingGet 时,RxJava 可能会抛出 OnErrorNotImplementedException 或原始异常。如果未在订阅链中定义错误处理器,RxJava 会将异常包装在 OnErrorNotImplementedException 中抛出。这意味着 @ControllerAdvice 捕获到的异常类型将是 OnErrorNotImplementedException,其 Cause 才是原始业务异常。开发者需要在异常处理器中解包 Cause 才能获取真实的错误信息。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











