Spring声明式事务回滚时如何保留自定义异常信息？

核心原因 #

Spring事务切面在触发回滚后会原样抛出方法内抛出的异常，不会主动覆盖信息。出现异常信息丢失，大概率是以下两点：

• 自定义异常未正确携带原始异常的根源信息；
• 项目中存在全局异常处理器或其他AOP切面拦截并重新包装了异常。

解决方案 #

1. 完善自定义异常的构造逻辑 #

不要仅传递异常message，要将原始异常作为cause传入，保留完整的异常链路：

// 服务层方法内的try-catch
try {
    // 业务逻辑代码
} catch (Exception e) {
    // 传入原始异常作为cause，避免信息丢失
    throw new BusinessException(e.getMessage(), e);
}

同时在自定义异常类中添加带Throwable参数的构造方法：

public class BusinessException extends Exception {
    // 带message和cause的构造方法
    public BusinessException(String message, Throwable cause) {
        super(message, cause);
    }

    // 其他必要的构造方法（如仅带message的）
    public BusinessException(String message) {
        super(message);
    }
}

2. 排查异常链路中的拦截逻辑 #

• 检查全局异常处理器：查看项目中@ControllerAdvice或@RestControllerAdvice标注的类，是否存在捕获BusinessException后重新包装成其他异常的代码，比如：

  // 错误示例：覆盖了自定义异常信息
  @ExceptionHandler(BusinessException.class)
  public Result handleBusinessException(Exception e) {
      return BackProResult.returnError("系统异常");
  }
  

  修正为保留原异常信息：

  @ExceptionHandler(BusinessException.class)
  public Result handleBusinessException(BusinessException e) {
      return BackProResult.returnError(e.getMessage());
  }
  

• 检查自定义AOP切面：排查是否有其他AOP切面在事务切面之后执行，拦截了异常并修改内容。

3. 优化事务注解的精准性 #

将@Transactional标注在具体业务方法上，并指定rollbackFor为自定义异常类，减少不必要的异常匹配：

@Transactional(rollbackFor = BusinessException.class)
public void yourBusinessMethod() {
    try {
        // 业务逻辑
    } catch (Exception e) {
        throw new BusinessException(e.getMessage(), e);
    }
}

4. 控制器层正确获取异常信息 #

如果需要获取原始异常的细节，可以通过e.getCause()拿到根源异常：

// 控制器层的try-catch
try {
    businessService.yourBusinessMethod();
    return BackProResult.returnSuccess();
} catch (BusinessException e) {
    String errorMsg = e.getMessage();
    // 可选：拼接原始异常信息
    if (e.getCause() != null) {
        errorMsg += "，详情：" + e.getCause().getMessage();
    }
    return BackProResult.returnError(errorMsg);
}

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