HikariCP 连接池

// 每次请求都创建和关闭连接
public User getUser(int id) {
    Connection conn = DriverManager.getConnection(url, user, password); // 耗时操作
    // ... 执行查询
    conn.close(); // 耗时操作
}

应用程序                    连接池                     数据库
    │                         │                         │
    │── 请求连接 ─────────────→│                         │
    │                         │── 复用已建立连接 ───────→│
    │←──────── 返回连接 ──────│                         │
    │                         │                         │
    │── 归还连接 ─────────────→│←── 连接保持 ───────────│
    │                         │                         │

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC
    username: root
    password: password
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      # 连接池名称
      pool-name: MyHikariPool
      
      # 最小空闲连接数
      minimum-idle: 5
      
      # 最大连接数
      maximum-pool-size: 20
      
      # 连接超时时间（毫秒）
      connection-timeout: 30000
      
      # 空闲连接存活最大时间（毫秒）
      idle-timeout: 600000
      
      # 连接最大存活时间（毫秒）
      max-lifetime: 1800000
      
      # 连接测试查询
      connection-test-query: SELECT 1

最大连接数 = (核心数 * 2) + 有效磁盘数

例如：8核CPU + 1块磁盘 = (8 * 2) + 1 = 17

应用程序请求连接
       ↓
检查空闲连接列表
       ↓
有可用连接？ → 是 → 验证连接有效性 → 返回连接
       ↓ 否
当前连接数 < 最大值？
       ↓ 是              ↓ 否
创建新连接          等待其他连接释放
       ↓                    ↓
返回连接           超时？ → 抛异常

应用程序归还连接
       ↓
重置连接状态（回滚事务、清除警告等）
       ↓
当前空闲连接数 < 最小空闲数？
       ↓ 是            ↓ 否
放入空闲池       关闭连接

// 连接泄露：忘记关闭连接
public void leak() {
    Connection conn = dataSource.getConnection();
    // 业务逻辑...
    // 忘记 conn.close()
}

spring:
  datasource:
    hikari:
      # 连接泄露检测阈值（毫秒）
      # 连接借出超过此时间未归还，记录警告日志
      leak-detection-threshold: 60000  # 60秒

警告 - Connection leak detection triggered for connection xxx
Connection has been out of pool for 60001ms

Caused by: java.sql.SQLTransientConnectionException: 
HikariPool - Connection is not available, request timed out after 30000ms

# 增大连接池
maximum-pool-size: 30
 
# 增加超时时间
connection-timeout: 60000
 
# 检查泄露
leak-detection-threshold: 30000

@Configuration
public class DataSourceConfig {
    
    @Bean
    public DataSource dataSource() {
        HikariDataSource ds = new HikariDataSource();
        // ... 配置参数
        
        // 预热连接池
        ds.getConnection().close(); // 触发初始化
        
        return ds;
    }
}

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?autoReconnect=true
    hikari:
      # 连接最大存活时间小于 MySQL wait_timeout
      max-lifetime: 1800000  # 30分钟
      
      # 定期测试连接
      connection-test-query: SELECT 1
      
      # 或使用 MySQL 驱动的自动重连
      # autoReconnect=true（已废弃，不推荐）

spring:
  datasource:
    hikari:
      register-mbeans: true

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

// 暴露 HikariCP 指标
@Bean
public MeterBinder hikariMetrics(HikariDataSource dataSource) {
    return new HikariDataSourceMetrics(dataSource, "my-pool", Collections.emptyList());
}

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root
    password: ${DB_PASSWORD}
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      pool-name: MyAppPool
      
      # 根据实际负载调整
      maximum-pool-size: 20
      minimum-idle: 5
      
      # 超时配置
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000
      
      # 泄露检测（生产环境建议开启）
      leak-detection-threshold: 60000
      
      # 连接验证
      validation-timeout: 5000

公式：(CPU核心数 * 2) + 磁盘数

实际：需要结合业务压测调整
- 太大：数据库压力大，上下文切换开销
- 太小：并发请求排队等待

HikariCP 核心要点：
1. 性能最优：字节码优化 + ConcurrentBag
2. 关键配置：maximum-pool-size、connection-timeout
3. 泄露检测：leak-detection-threshold
4. 连接数公式：(核心数 * 2) + 磁盘数
5. 监控指标：活跃连接、空闲连接、等待线程