Spring Boot JPA中如何从Hibernate的SQLExceptionHelper获取SQL Server自定义错误信息

核心问题 #

你遇到的是JPA将底层SQLException多层包装成PersistenceException的问题，直接调用e.getCause()可能只拿到中间层异常，没触达最底层的SQL异常。

解决思路：遍历异常链提取底层SQLException #

JPA（比如Hibernate实现）会把SQL Server抛出的异常层层包装，你需要递归或循环遍历异常的cause链，找到真正的SQLException实例，就能获取自定义错误码和消息。

修改后的捕获逻辑示例 #

@Override
public int addStudentBySPROC(String displayName) throws TestStudentStoredProcedureException {
    try {
        testStudentRepo.addStudent(displayName);
    } catch (PersistenceException e) {
        // 遍历异常链找SQLException
        Throwable current = e;
        while (current != null && !(current instanceof SQLException)) {
            current = current.getCause();
        }
        if (current instanceof SQLException sqlEx) {
            int errorCode = sqlEx.getErrorCode(); // 拿到237820
            String errorMsg = sqlEx.getMessage(); // 拿到Testing error code handling
            System.out.println("错误码：" + errorCode + "，错误消息：" + errorMsg);
            // 这里可以根据错误码做自定义处理，比如抛自定义业务异常
            throw new TestStudentStoredProcedureException(errorMsg, errorCode);
        }
        // 如果没找到SQL异常，处理其他情况
        throw new TestStudentStoredProcedureException("存储过程调用失败", e);
    }
    return 0;
}

额外注意点 #

1. 存储过程里的错误抛出优化：你代码里先写了RAISERROR再THROW，其实THROW会终止存储过程执行，前面的RAISERROR不会生效。建议只保留THROW语句，确保抛出的是你定义的自定义错误码。
2. SQL Server自定义错误码范围：虽然THROW支持自定义错误码，但尽量避免使用系统预留的错误码（0-50000是系统错误码范围，建议用50001及以上的码，避免冲突）。
3. 为什么不用OUT参数：用异常传递错误更符合Java的错误处理语义，OUT参数会让存储过程的返回语义混淆（正常返回业务数据，错误返回码，不符合单一职责），所以优先用异常链提取的方式。

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