如何从DataIntegrityViolationException提取SQLException异常信息

我来帮你完善这个提取SQLException错误信息的方法，同时分享一些更友好的异常处理思路~

基础版：提取原始SQL错误信息 #

你原来的思路完全正确——因为DataIntegrityViolationException的直接异常原因通常是Hibernate的ConstraintViolationException，底层才是真正的SQLException，所以必须遍历异常链才能拿到具体错误。补全后的方法如下：

private String getSQLExceptionMessage(DataIntegrityViolationException e) {
    Throwable currentException = e.getCause();
    // 遍历异常链，直到找到SQLException或者遍历完所有层级
    while (currentException != null) {
        if (currentException instanceof SQLException) {
            // 返回SQL异常的具体错误描述
            return ((SQLException) currentException).getMessage();
        }
        currentException = currentException.getCause();
    }
    // 如果没找到SQLException，返回通用提示+原异常信息兜底
    return "数据库操作失败：" + e.getMessage();
}

进阶版：返回用户友好的提示 #

直接返回SQL原生错误信息对终端用户不太友好，你可以根据SQL错误码（SQLState）做针对性的友好提示，覆盖常见的约束冲突场景：

private String getFriendlyErrorMessage(DataIntegrityViolationException e) {
    Throwable currentException = e.getCause();
    while (currentException != null) {
        if (currentException instanceof SQLException) {
            SQLException sqlEx = (SQLException) currentException;
            String sqlState = sqlEx.getSQLState();
            
            // 唯一键冲突（不同数据库SQLState略有差异，这里列举主流值）
            if ("23000".equals(sqlState) || "23505".equals(sqlState)) {
                return "数据重复：该记录已存在，请检查输入内容";
            }
            // 外键约束异常（比如删除了被关联的依赖数据）
            else if ("23503".equals(sqlState)) {
                return "关联数据异常：无法执行当前操作，请先处理相关联的记录";
            }
            // 字段长度超出限制
            else if ("22001".equals(sqlState)) {
                return "输入内容过长：请缩短相关字段的内容";
            }
            // 其他情况返回原始SQL错误信息
            return sqlEx.getMessage();
        }
        currentException = currentException.getCause();
    }
    return "数据库操作失败，请稍后重试";
}

最佳实践：全局异常处理 #

在Spring项目中，建议用@ControllerAdvice实现全局异常处理，统一返回标准化的错误响应，避免在每个接口里重复写异常处理逻辑：

@ControllerAdvice
public class GlobalDatabaseExceptionHandler {

    @ExceptionHandler(DataIntegrityViolationException.class)
    public ResponseEntity<ApiErrorResponse> handleDataIntegrityViolation(DataIntegrityViolationException e) {
        String friendlyMsg = getFriendlyErrorMessage(e);
        ApiErrorResponse errorResponse = new ApiErrorResponse(
            HttpStatus.BAD_REQUEST.value(),
            "数据库操作错误",
            friendlyMsg
        );
        return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
    }

    // 上面的getFriendlyErrorMessage方法放在这里
    private String getFriendlyErrorMessage(DataIntegrityViolationException e) {
        // 实现同上
    }

    // 定义标准化的错误响应类
    static class ApiErrorResponse {
        private int status;
        private String title;
        private String detail;

        public ApiErrorResponse(int status, String title, String detail) {
            this.status = status;
            this.title = title;
            this.detail = detail;
        }

        // getter方法（按需添加setter）
        public int getStatus() { return status; }
        public String getTitle() { return title; }
        public String getDetail() { return detail; }
    }
}

这样无论哪个接口抛出DataIntegrityViolationException，都会自动返回结构统一的JSON错误响应，前端可以直接解析展示给用户。

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