Spring Boot如何自定义处理SQL ConstraintViolationException获取具体报错

方案1：细化异常链路解析，按错误类型返回友好提示 #

通过层层遍历异常栈获取底层原生SQLException，根据数据库错误码判断异常场景，返回对应提示：

@ExceptionHandler(DataIntegrityViolationException.class)
protected ResponseEntity<Object> handleDataIntegrityViolation(DataIntegrityViolationException ex, WebRequest request) {
    // 遍历获取根异常
    Throwable rootCause = ex;
    while (rootCause.getCause() != null && rootCause != rootCause.getCause()) {
        rootCause = rootCause.getCause();
    }

    if (rootCause instanceof SQLException sqlEx) {
        int errorCode = sqlEx.getErrorCode();
        // MySQL外键约束违反错误码：1451（删除父记录）、1452（新增/更新子记录关联不存在的父记录）
        if (errorCode == 1451 || errorCode == 1452) {
            // 可维护约束名与业务提示的映射表，实现更精准的业务化提示
            // Map<String, String> constraintTipMap = Map.of("fk_cpo_production_cycle_cpo_cycle_type1", "当前周期类型已关联生产周期，无法删除");
            return buildResponseEntity(new ApiError(HttpStatus.CONFLICT, "当前记录存在其他表关联引用，无法操作", ex));
        } 
        // MySQL唯一键冲突错误码：1062
        else if (errorCode == 1062) {
            return buildResponseEntity(new ApiError(HttpStatus.CONFLICT, "当前录入内容已存在，请勿重复提交", ex));
        }
    }

    if (ex.getCause() instanceof ConstraintViolationException) {
        return buildResponseEntity(new ApiError(HttpStatus.CONFLICT, "数据库操作冲突", ex));
    }
    return buildResponseEntity(new ApiError(HttpStatus.INTERNAL_SERVER_ERROR, "服务器内部错误", ex));
}

注意事项：

• 不同数据库的错误码存在差异，Oracle外键约束错误码为2292，唯一键冲突错误码为1，需根据实际使用的数据库调整错误码判断逻辑
• 若需针对特定约束返回业务化精准提示，可提前维护约束名-友好提示映射关系，从异常信息中解析出约束名后匹配对应提示返回即可

方案2：业务层前置关联校验 #

执行删除、更新等可能触发约束异常的操作前，主动查询关联表是否存在关联数据，提前抛出自定义业务异常，该方案与数据库实现解耦，无需适配不同数据库错误码，可维护性更高：

// 业务层校验逻辑示例
public void deleteCycleType(Long cycleTypeId) {
    if (productionCycleMapper.existsByCycleTypeId(cycleTypeId)) {
        throw new BusinessException("当前周期类型已关联生产周期，无法删除");
    }
    cycleTypeMapper.deleteById(cycleTypeId);
}

全局异常切面中新增自定义BusinessException的处理逻辑，直接返回异常中定义的友好提示即可。

方案3：扩展ApiError字段支持定制化处理 #

可扩展ApiError类新增constraintName等字段，解析异常时提取约束名赋值到响应中，前端可根据约束名做定制化提示处理。

内容的提问来源于stack exchange，提问作者Aldo Inácio da Silva