Spring Boot 2.4.x + jOOQ场景下触发器抛出异常映射异常问题

你遇到的这个异常映射变化确实是Spring Boot 2.4.x版本与jOOQ、JDBC整合时的兼容性问题，核心是针对数据库触发器抛出的自定义SQL异常的处理逻辑发生了改变。下面我们来拆解问题根源，并给出可行的解决方案：

问题根源分析 #

Spring Boot 2.4.x升级了Spring JDBC组件的版本，其中SQLExceptionTranslator（SQL异常转换器）的实现逻辑做了调整：

• 在2.4.0~2.4.2版本中，由于异常处理流程中某些参数未正确初始化，直接抛出了NullPointerException，完全丢失了触发器的错误信息；
• 2.4.3版本修复了NPE问题，但又对未明确归类的SQL状态（比如你使用的45000，属于用户自定义异常状态）做了泛化处理，只返回"Unspecified RuntimeException"，同样丢失了原始的触发器错误文本。

而重复键、外键这类标准SQL错误，因为有明确的异常映射规则，所以处理逻辑不受影响。

可行解决方案 #

方案1：自定义jOOQ异常转换器 #

通过自定义ExceptionTranslator，强制保留原始SQL异常的所有信息，包括触发器抛出的错误文本。你可以在配置类中添加如下代码：

@Configuration
public class JooqCustomConfig {
    @Bean
    public DefaultConfigurationCustomizer jooqConfigurationCustomizer() {
        return configuration -> {
            configuration.exceptionTranslator(new DefaultExceptionTranslator() {
                @Override
                public DataAccessException translate(String sql, SQLException e) {
                    // 拼接包含原始错误信息的提示文本
                    String detailedMessage = String.format(
                        "执行SQL [%s] 出错: SQL状态码[%s], 错误码[%d], 详情: %s",
                        sql, e.getSQLState(), e.getErrorCode(), e.getMessage()
                    );
                    // 返回包含原始SQLException的DataAccessException
                    return new DataAccessException(detailedMessage, e);
                }
            });
        };
    }
}

配置后，当触发器抛出异常时，你捕获到的DataAccessException会包含完整的错误信息，其中就有触发器定义的"some error"。

方案2：直接从嵌套异常中提取信息 #

在业务代码中捕获jOOQ的DataAccessException后，逐层获取嵌套的SQLException，从中提取触发器的错误信息。这个方案适用于Spring Boot 2.4.3及以上版本（先解决NPE问题）：

@Transactional
public void withTriggerException() {
    try {
        create.insertInto(DSL.table("tab1"))
              .set(DSL.field("k"), 1)
              .execute();
    } catch (DataAccessException dae) {
        Throwable rootCause = dae.getCause();
        if (rootCause instanceof SQLException) {
            SQLException sqlException = (SQLException) rootCause;
            String triggerErrorMessage = sqlException.getMessage();
            // 将原始错误信息转换为你的业务异常
            throw new YourBusinessException(triggerErrorMessage, sqlException);
        }
        // 非SQL异常直接抛出
        throw dae;
    }
}

这样就能直接拿到触发器定义的错误文本，再转换为业务层需要的异常类型。

方案3：升级Spring Boot版本 #

这个异常处理的问题在Spring Boot 2.4.4及后续的2.4.x小版本，以及2.5.x及以上的大版本中已经被官方修复。如果你的项目允许升级版本，这是最省心的解决方案——升级后，异常处理逻辑会恢复到类似2.3.x版本的状态，你可以直接从捕获的异常中获取触发器的错误信息。

验证方法 #

无论采用哪种方案，你都可以在捕获异常后，通过e.getMessage()或者打印异常栈轨迹的方式，确认是否包含触发器定义的"some error"文本，以此验证方案是否生效。

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