连接池核心参数，你真的懂了吗？
连接池的配置，说白了就是一堆数字游戏。但每个数字背后，都藏着一条线上线的命。
我个人习惯，拿到一个新项目，第一件事就是去看连接池参数。不是因为它有多高大上，而是因为我亲眼见过一个默认配置的线程池，在生产压力下瞬间把数据库打崩。那次事故之后，我就养成了这个习惯。
今天咱们就把这些参数挨个捋一遍。不画大饼，只说实战中怎么用。
参数总览：一张表说清楚
先给你一张全景图。下面这个表格，是我在多个DLP项目中反复验证过的核心参数清单。你把它存成思维导图也好，截图放桌面上也行，每次调优时对照着看。
| 参数名 | 默认值 | 核心作用 | 我的常用范围 |
|---|---|---|---|
| minimumIdle | 10 | 最小空闲连接数 | 5 ~ 20 |
| maximumPoolSize | 10 | 最大连接数（核心上限） | 10 ~ 50 |
| connectionTimeout | 30000ms | 获取连接的最大等待时间 | 1000 ~ 5000ms |
| idleTimeout | 600000ms | 空闲连接的最大存活时间 | 300000 ~ 600000ms |
| maxLifetime | 1800000ms | 连接的最大生命周期 | 600000 ~ 1800000ms |
| keepaliveTime | 0（不开启） | 连接断开检测间隔 | 30000 ~ 60000ms |
| validationQuery | 无 | 连接有效性校验SQL | SELECT 1 |
我为什么先讲这六个参数
你可能会问：连接池参数少说也有十几个，为什么就挑这几个？
原因很简单。我经历过几个DLP接口压测场景，最后发现90%的性能问题，都出在这六个参数上。其他的像poolName、threadFactory这些，基本都是运维层面的东西，跟调优关系不大。
好，咱们一个一个来。
1. maximumPoolSize —— 这条红线，别踩过界
这是最直观的参数，也最容易被人误解。很多人觉得，连接数设得越大，系统就越快。你想想看，真的是这样吗？
我在项目中遇到过一位同事，他把maxPoolSize设成了200。结果呢？数据库连接数瞬间飙满，CPU被打到90%，原本50ms的查询变成了2秒。道理很简单：操作系统切换线程也是要花钱的。
核心数 × 2 + 有效磁盘数 来估算初始值。如果你的服务器是4核8线程，那maxPoolSize在10~15之间就差不多了。
2. minimumIdle —— 随时待命的备胎
这个参数的意思是：池子里至少要留多少个空闲连接，随时准备给请求用。
我建议设成跟maxPoolSize一样大。为什么？因为这样能避免「冷启动」——就是当流量突然上来时，池子从0开始创建连接，那几秒的延迟足够让用户感觉到卡顿。
当然，如果你的内存特别紧张，可以适当调小，但不建议低于5。
3. connectionTimeout —— 等太久，不如不等
这个参数定义的是：一个请求从池子里拿连接，最多愿意等多久。
说实话，这个参数最容易让人翻车。我记得有一次线上事故，就是因为connectionTimeout设成了30秒。接口被慢SQL堵住，所有请求都在排队等连接，30秒超时后立马抛出异常，然后客户端重试，又把新的请求塞进来……最后数据库直接挂掉。
4. idleTimeout —— 别让空连接占着茅坑不拉屎
当一个连接空闲超过这个时间，连接池就会把它关掉。
曾见过有人把idleTimeout设成0，意思是永远不关闭空闲连接。结果服务器上积累了上万个废弃连接，DBA都打电话来骂人了。
我一般设为10分钟（600000ms）。如果你做的是高频短连接的DLP接口，甚至可以缩短到5分钟。
5. maxLifetime —— 任何连接都有保质期
这跟idleTimeout有什么区别？
区别大了。idleTimeout管的是「空闲太久」的连接，maxLifetime管的是「活得够久」的连接——不管它有没有在用，到了时间都得销毁重建。
为什么要这样？因为数据库、防火墙、负载均衡设备，都有自己对连接的超时机制。你不主动销毁，它们也会在某个时间把你的连接静默断开。等你下次再用这个连接，它会抛出一堆奇怪的异常。
我一般把maxLifetime设为30分钟，比数据库端的超时阈值略小。
6. keepaliveTime —— 心跳信号，防止假死
这个参数很多框架默认不开启。但我强烈建议你打开它。
我自己的踩坑经历：有一个DLP接口运行得好好的，但每过半小时就会突然慢几秒钟。查了好几天才发现，是防火墙那边每隔30分钟会断开空闲连接，而连接池没有心跳检测，等到下一次用的时候才发现连接已死，只能重建——那几秒的卡顿就是这么来的。
参数之间的依赖关系
上面讲的这些参数不是孤立的。它们彼此影响，就像一个连动的齿轮组。下面这张图，我把它们的关系画出来了，你一看就明白。
看着这张图，你就能理解为什么我建议先调maxPoolSize，再调其他的了。它就像一个锚点，所有参数都围着它转。
一个典型的配置示例
最后，给你一个我目前在DLP接口上正在用的配置。你可以直接拿来当起点，再根据你的实际场景微调。
// HikariCP 配置示例（DLP接口场景）
dataSource.setMaximumPoolSize(15);
dataSource.setMinimumIdle(15);
dataSource.setConnectionTimeout(3000); // 3秒等不到就放弃
dataSource.setIdleTimeout(600000); // 10分钟空闲回收
dataSource.setMaxLifetime(1800000); // 30分钟连接重建
dataSource.setKeepaliveTime(30000); // 每30秒心跳一次
dataSource.setConnectionTestQuery("SELECT 1");
dataSource.setValidationTimeout(1000); // 心跳超时1秒说完这些参数，你应该能感觉到，连接池调优不是单纯地改改数字就完事了。它更像是在「快、稳、省」之间做权衡。快，是连接获取及时；稳，是不断连不假死；省，是不浪费连接资源。
下次你动手调优的时候，不妨先想想这几个参数各自管什么，再看它们之间的关系。你会发现，那些以前玄学般的调优，一下子就清晰了。