spring boot 全局异常处理可以通过配置 @controlleradvice 结合 @exceptionhandler 来捕获连接池异常。具体做法是定义一个全局异常处理器类，在其中添加针对 sqlexception 或特定连接池异常（如 com.zaxxer.hikari.pool.hikaripool$poolinitializationexception）的处理方法，返回统一的错误响应。
如何捕获 HikariCP 初始化失败异常？
当数据库连接池在启动时因配置错误或网络问题无法创建初始连接时，会抛出 HikariPool$PoolInitializationException。通过在全局异常处理器中显式声明对该异常的捕获，可以拦截启动阶段的致命错误并记录日志。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
@GetMapping("/test")
public String test() {
return "ok";
}
}
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import com.zaxxer.hikari.pool.HikariPool;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HikariPool.PoolInitializationException.class)
public ResponseEntity<String> handleHikariError(HikariPool.PoolInitializationException ex) {
// 记录详细日志以便排查
System.err.println("Connection pool initialization failed: " + ex.getMessage());
return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE).body("Database connection pool is unavailable");
}
}
上述代码展示了如何针对 HikariCP 特有的初始化异常进行捕获。当应用启动时若连接池配置有误，该处理器将返回 503 Service Unavailable 状态码及自定义消息。注意，此方法仅适用于 Spring MVC/WebFlux 环境下的 Web 请求触发或启动阶段暴露的异常。
如何捕获运行时 SQL 执行异常？
在业务逻辑执行过程中，若发生数据库连接断开、SQL 语法错误或事务超时等运行时异常，通常会抛出 java.sql.SQLException 或其子类。全局异常处理器应覆盖此类通用异常，以确保所有 DAO 层抛出的数据库相关错误都能被统一接管。
import java.sql.SQLException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(SQLException.class)
public ResponseEntity<String> handleSqlException(SQLException ex) {
System.err.println("SQL execution error: " + ex.getMessage());
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Database operation failed");
}
}
该处理器优先于其他更通用的异常处理器（如 RuntimeException），因为 SQLException 是更具体的类型。在实际项目中，建议根据异常根因（Root Cause）进一步细分处理策略，例如区分“连接丢失”与“数据约束冲突”，从而返回不同的 HTTP 状态码和提示信息。
当连接池耗尽时会返回什么结果？
当所有连接都被占用且没有可用空闲连接时，HikariCP 会在等待超时后抛出 TimeoutException 或 SQLTransientConnectionException。此时全局异常处理器若未专门捕获这些异常，可能会由默认的 RuntimeException 处理器兜底，导致客户端收到 500 Internal Server Error。因此，建议在 @RestControllerAdvice 中增加对 java.util.concurrent.TimeoutException 的处理，以提供更明确的语义。
