如何从RollbackException或TransactionSystemException中提取实际错误信息

核心原因 #

JPA实体校验默认在事务提交、持久化上下文刷新阶段触发，因此校验异常会被多层包装到TransactionSystemException的异常嵌套链中，外层直接获取的异常信息不包含实际的校验提示，需要手动拆解异常链提取。

方法1：从嵌套异常中提取校验信息 #

你可以在捕获异常后逐层解包，拿到最内层的ConstraintViolationException，从中取出所有校验错误信息返回给用户，参考代码如下：

catch (Exception e) {
    String errorMsg = "操作失败，请检查输入参数后重试";
    // 逐层拆解异常链
    if (e instanceof TransactionSystemException) {
        Throwable rollbackCause = e.getCause();
        if (rollbackCause instanceof RollbackException) {
            Throwable validationCause = rollbackCause.getCause();
            if (validationCause instanceof ConstraintViolationException) {
                ConstraintViolationException validEx = (ConstraintViolationException) validationCause;
                // 拼接所有校验错误提示
                errorMsg = validEx.getConstraintViolations()
                        .stream()
                        .map(ConstraintViolation::getMessage)
                        .collect(Collectors.joining("；"));
            }
        }
    }
    newsm.setText(errorMsg);
    log.error("收入添加失败", e); // 保留完整异常栈方便后端排查
}

需要提前引入对应异常类的依赖：

• org.springframework.transaction.TransactionSystemException
• javax.persistence.RollbackException
• javax.validation.ConstraintViolationException
• javax.validation.ConstraintViolation

方法2：更推荐的前置校验方案（避免嵌套异常处理） #

等事务提交才捕获校验错误的效率较低，你可以选择提前触发校验，直接拿到原始错误信息：

• 方案A：开启Spring方法级校验
  给业务类添加@Validated注解，在addIncome方法的income参数上直接加@NotNull、@DecimalMin校验注解，调用方法时就会直接抛出ConstraintViolationException，不需要等事务提交，无需解包即可直接获取错误信息。
• 方案B：Bot接收层提前校验
  在收到用户输入时就做参数校验：先判断输入内容是否可转为合法BigDecimal，再判断数值是否大于0，不合法直接返回错误提示，不需要调用业务层，响应速度更快。

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