HikariCP的maximumPoolSize设过高会因超数据库连接上限引发线程争抢、上下文切换和锁竞争而拖垮性能；建议设为数据库max_connections×0.6÷应用实例数，并配合适当超时与回收策略。
为什么 HikariCP 的 maximumPoolSize 设太高反而变慢
连接数不是越多越好，超过数据库能承受的并发连接上限后，线程争抢、上下文切换、锁竞争会直接拖垮性能。MySQL 默认 max_connections=151，PostgreSQL 通常在 100–200 区间，而应用端设 maximumPoolSize=100 意味着单实例就占掉大半资源。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先查数据库当前最大连接数：
SHOW VARIABLES LIKE 'max_connections';（MySQL）或SHOW config FOR 'max_connections';（PostgreSQL） - 应用侧
maximumPoolSize建议设为数据库 max_connections × 0.6 ÷ 应用实例数，比如 3 台服务共连一个 MySQL（max_connections=200），单台设40比较稳妥 - 务必开启
leakDetectionThreshold（如60000，单位毫秒），避免连接未归还导致池子“悄悄枯竭”
connectionTimeout 和 validationTimeout 到底该设多少
这两个超时值不匹配会导致连接池反复重试无效连接，或者卡在验证阶段阻塞业务线程。常见错误是把 connectionTimeout 设成 30000（30 秒），但 validationTimeout 还是默认的 5000（5 秒）——当数据库响应慢时，验证失败后池子会立刻再试，反复触发 30 秒等待。
实操建议：
立即学习“Java免费学习笔记（深入）”；
-
connectionTimeout控制“从池里拿连接”的最大等待时间，线上建议3000（3 秒），超时应快速失败而非卡住请求 -
validationTimeout必须 小于connectionTimeout，推荐2500，且要略短于数据库的wait_timeout（MySQL 默认 8 小时，但中间网络设备可能更短） - 如果用
testOnBorrow=false（推荐），则必须配connectionTestQuery=SELECT 1（MySQL）或SELECT 1（PostgreSQL），否则验证逻辑不生效
为什么加了 dataSourceClassName 还报 ClassNotFoundException
HikariCP 不自动加载 JDBC 驱动类，只负责管理连接；dataSourceClassName 是指定数据源实现类（如 com.zaxxer.hikari.HikariDataSource），不是 JDBC 驱动类。真正要配的是 driverClassName 或让驱动自己注册（JDBC 4.0+）。
常见错误现象：
- Spring Boot 2.4+ 中移除了自动驱动注册，没显式配
driver-class-name就报ClassNotFoundException: com.mysql.cj.jdbc.Driver - Maven 依赖漏了
mysql-connector-java或版本太低（如 5.x 驱动不兼容 MySQL 8.0+）
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 显式声明驱动：
driverClassName=com.mysql.cj.jdbc.Driver（MySQL 8+）或org.postgresql.Driver（PostgreSQL） - 确认依赖版本匹配：MySQL 8.0+ 对应
mysql:mysql-connector-java:8.0.33，别用5.1.49 - Spring Boot 用户优先用
spring.datasource.url=jdbc:mysql://...自动推导，比手动配dataSourceClassName更少出错
空闲连接回收：用 idleTimeout 还是 maxLifetime
两者作用不同但常被混用：idleTimeout 是连接空闲多久后被驱逐，maxLifetime 是连接从创建起最多活多久。数据库连接池和中间件（如 RDS 代理、防火墙）都会主动断开长时间空闲连接，只靠 idleTimeout 不足以防止 Connection reset。
实操建议：
立即学习“Java免费学习笔记（深入）”；
-
maxLifetime必须比数据库的wait_timeout短至少 30 秒，例如 MySQLwait_timeout=28800（8 小时），则设maxLifetime=28000000（7 小时 46 分） -
idleTimeout推荐600000（10 分钟），避免连接长期空闲却被中间设备悄无声息地 kill - 禁用
keepaliveTime（HikariCP 5.0+ 才支持），旧版本无法靠它保活，别白费劲
最易被忽略的是数据库端的超时配置和应用端的 maxLifetime 同步——改了代码不调数据库参数，等于只系了一半鞋带。
