spring boot 全局异常处理通过 @restcontrolleradvice 配合 @exceptionhandler 捕获数据库异常。核心做法是拦截 dataaccessexception 及其子类,在统一入口中解析异常原因并返回标准 json 响应。这样无论 dao 层抛出的是主键冲突、连接超时还是 sql 语法错误,前端都能收到结构一致的错误码和提示信息。

@ControllerAdvice 如何拦截 DataAccessException
直接回答:使用 @RestControllerAdvice 类中的方法,指定 value = DataAccessException.class 即可捕获所有数据库相关异常。该基类涵盖了从连接失败到约束违规的所有 JDBC 异常,无需逐个编写处理器。

import org.springframework.dao.DataAccessException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.ResponseEntity;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(DataAccessException.class)
public ResponseEntity<string> handleDataAccessError(DataAccessException ex) {
String message = "Database error: " + ex.getMostSpecificCause().getMessage();
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(message);
}
}</string>
上述代码定义了一个全局异常处理器。当 Spring 事务管理器或 JPA/Hibernate 抛出 DataAccessException 时,该方法会被触发。通过调用 getMostSpecificCause() 可以获取最底层的异常信息(如 MySQL 的 MySQLIntegrityConstraintViolationException),从而提取具体的错误描述。返回的 ResponseEntity 将状态码设为 500,并将错误信息封装在 Body 中。
如何区分主键冲突与连接超时
直接回答:在 @ExceptionHandler 内部通过 instanceof 判断具体子类,针对 DataIntegrityViolationException 返回 400 状态码,针对 CannotAcquireResourceException 返回 503 状态码。这种细分能让前端根据状态码决定是提示用户修改输入,还是稍后重试。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。

import org.springframework.dao.DataIntegrityViolationException;
import org.springframework.dao.CannotAcquireResourceException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.ResponseEntity;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(DataIntegrityViolationException.class)
public ResponseEntity<string> handleIntegrityError(DataIntegrityViolationException ex) {
return ResponseEntity.badRequest().body("Duplicate key or constraint violation");
}
@ExceptionHandler(CannotAcquireResourceException.class)
public ResponseEntity<string> handleConnectionError(CannotAcquireResourceException ex) {
return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE).body("Database unavailable");
}
}</string></string>
这段代码展示了更精细的处理逻辑。虽然 DataAccessException 能捕获所有数据库异常,但业务上通常需要将“数据错误”与“系统故障”区分开。DataIntegrityViolationException 通常由唯一索引冲突引起,属于客户端输入问题,因此返回 400 Bad Request。而 CannotAcquireResourceException 表示无法获取数据库连接,属于基础设施问题,返回 503 Service Unavailable 更符合 RESTful 规范。开发者可以根据实际抛出的异常类型,在同一个 Advice 类中添加多个处理方法,Spring 会优先匹配最具体的异常类型。
事务回滚对异常捕获的影响
直接回答:如果数据库异常发生在 @Transactional 方法内且未被捕获,Spring 会自动标记事务为 rollback-only 并回滚。全局异常处理器捕获异常后,事务已经回滚,此时返回的错误信息仅用于通知前端,不会改变数据库状态。若需手动控制回滚,可在 @ExceptionHandler 中显式抛出 RuntimeException 以触发默认的回滚行为。










