Spring无法捕获MySQL抛出的SQLException仅触发全局Exception

Spring Data JPA 等ORM框架不会将JDBC层原生的SQLException直接抛到业务调用层，框架会统一把所有底层数据库异常转换为Spring内置的数据访问异常体系（DataAccessException 及其子类），这类异常属于非受检的RuntimeException子类，和你声明捕获的SQLException不存在继承关系，因此全局异常处理器无法匹配到对应的处理分支。

你在MySQL客户端看到的1451外键约束删除错误，会被框架转换为org.springframework.dao.DataIntegrityViolationException（数据完整性违反异常），最终被全局的通用Exception处理器捕获，返回500错误。你在方法上声明throws SQLException、自定义SQLException子类都无法生效，因为框架层根本不会向上抛出SQLException类型的异常。

• 直接替换异常捕获的类型：将全局异常处理器中原来匹配SQLException的方法，改为匹配Spring封装后的数据访问异常。针对外键约束、唯一键约束这类数据完整性错误，直接捕获DataIntegrityViolationException即可命中对应分支，示例代码：

@ExceptionHandler(DataIntegrityViolationException.class)
@ResponseStatus(HttpStatus.NOT_ACCEPTABLE)
public ResponseEntity<Object> handleDBConstraintException(DataIntegrityViolationException ex, WebRequest request) {
    log.error("Database operation failed due to constraint violation", ex);
    // 可进一步解析异常信息判断是否为外键删除冲突，返回对应业务提示
    return buildErrorResponse(ex, HttpStatus.NOT_ACCEPTABLE, request);
}

• 如果需要获取原生SQLException做定制处理：捕获DataAccessException后，调用异常实例的getMostSpecificCause()或getRootCause()方法，就能提取到底层JDBC抛出的原生SQLException对象，可进一步判断错误码（比如1451）做细分逻辑。
• 移除service、controller方法上多余的throws SQLException声明，Spring的数据访问异常是非受检异常，不需要显式声明抛出。

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