spring boot 全局异常处理无法直接捕获分布式事务异常,因为分布式事务通常由框架(如 seata)在独立线程或远程调用中执行,其异常不会向上传播到主线程的 controller 层。要捕获这些异常,必须通过配置全局异常处理器拦截特定的业务异常类,或者在 service 层显式捕获并转换为统一返回格式。

Seata 全局异常传播机制是什么
Seata 的全局事务异常主要发生在 RM(资源管理器)阶段,当分支事务提交失败时,会抛出 `TransactionException` 或其子类。由于 Seata 使用 ThreadLocal 存储事务上下文,且远程调用可能涉及异步线程池,主线程的 `@ControllerAdvice` 往往捕获不到这些异常。因此,需要理解异常是如何从底层 RPC 调用向上抛出的,以及为什么它会被吞掉或导致连接超时。

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import io.seata.core.exception.TransactionException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(TransactionException.class)
public String handleTxException(TransactionException e) {
return "Transaction failed: " + e.getMessage();
}
}
如何在全局处理器中正确拦截此类异常
为了在全局异常处理器中捕获分布式事务异常,最直接的方法是让 Service 层在调用 Seata 接口时显式捕获 `TransactionException`,并将其包装为自定义的业务异常(如 `BizException`),然后由全局处理器统一处理。另一种方法是配置 Seata 的 `exception` 策略,使其将异常抛出到应用层。以下代码展示了如何在 Service 层进行显式捕获和转换,确保异常能到达 Controller 层。

import com.example.exception.BizException;
import io.seata.spring.annotation.GlobalTransactional;
import org.springframework.stereotype.Service;
@Service
public class OrderService {
@GlobalTransactional
public void createOrder() {
try {
// 模拟分布式事务操作
saveOrder();
reduceStock();
} catch (io.seata.core.exception.TransactionException e) {
throw new BizException("DISTRIBUTION_TX_FAILED", e.getMessage());
}
}
}
自定义 BizException 的具体定义与使用
自定义异常 `BizException` 是连接分布式事务异常与全局处理器的桥梁。它继承自 `RuntimeException`,包含错误码和消息。在 Service 层捕获到底层的 `TransactionException` 后,将其实例化为 `BizException` 抛出。这样,全局异常处理器只需针对 `BizException` 编写一个通用的处理方法,即可统一返回 JSON 格式的响应,避免重复的 try-catch 代码块。这种模式确保了无论分布式事务在哪个分支失败,都能被一致地处理。


















