c3p0连接池正常运行必须同时具备三个jar包：c3p0-0.9.5.5.jar（核心逻辑）、mchange-commons-java-0.2.19.jar（底层依赖）、对应数据库驱动jar；推荐使用c3p0-config.xml配置，关键参数包括initialpoolsize、maxpoolsize、checkouttimeout、idleconnectiontestperiod、maxidletime和maxconnectionage，需合理设置以避免连接失效或资源耗尽。
C3P0 连接池初始化不难，关键在依赖齐、配置准、参数合理。它不是丢一个 jar 就能跑的组件，漏掉配套依赖或配错核心参数，轻则连接获取失败，重则应用半夜告警。
必须带上的三个 jar 包
c3p0 从 0.9.2 版本起就拆成了两个独立模块，手动集成时极易遗漏：
- c3p0-0.9.5.5.jar：连接池核心逻辑，负责连接创建、复用、回收和故障检测
- mchange-commons-java-0.2.19.jar（注意：不是 0.2.1）：提供线程调度、异步执行、字符串工具等底层能力，c3p0 内部大量调用，缺它必报 NoClassDefFoundError
- 对应数据库驱动 jar（如 mysql-connector-java-8.0.33.jar）：没驱动，连数据库地址都解析不了
用 Maven 可自动拉取传递依赖；但老项目若手动拷 lib 目录，务必核对这三个文件是否都在 WEB-INF/lib 下。
三种主流配置方式选一种即可
推荐优先使用 c3p0-config.xml，结构清晰、支持多环境配置、便于运维查看。
-
XML 方式：在类路径（如 src/main/resources）下放
c3p0-config.xml，内容示例如下：
<c3p0-config><default-config><property name="driverClass">com.mysql.cj.jdbc.Driver</property><property name="jdbcUrl">jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC</property><property name="user">root</property><property name="password">123456</property><property name="initialPoolSize">5</property><property name="minPoolSize">5</property><property name="maxPoolSize">20</property><property name="acquireIncrement">5</property><property name="checkoutTimeout">3000</property><property name="maxIdleTime">1800</property><property name="maxConnectionAge">3600</property><property name="idleConnectionTestPeriod">30</property><property name="preferredTestQuery">SELECT 1</property><property name="testConnectionOnCheckin">true</property></default-config></c3p0-config>
-
properties 方式：新建
c3p0.properties（名字不能错），内容以c3p0.xxx开头，如：c3p0.jdbcUrl=jdbc:mysql://... - 代码方式：适合动态配置场景，但不推荐日常使用，易写错且难维护：
ComboPooledDataSource cpds = new ComboPooledDataSource();
cpds.setJdbcUrl("jdbc:mysql://...");
cpds.setUser("root");
cpds.setPassword("123456");
cpds.setInitialPoolSize(5);
cpds.setMaxPoolSize(20);
最该调优的 6 个参数
这些参数直接影响连接池是否“活得好”“用得稳”：
- initialPoolSize / minPoolSize / maxPoolSize：建议设为相同值（如都为 5～10），避免冷启动抖动；maxPoolSize 别盲目设太高，MySQL 默认最大连接数常为 151，超了会拒绝新连接
- acquireIncrement：当池空了，一次补多少连接。设为 3～5 较稳妥，避免单次请求触发大量建连开销
- checkoutTimeout：获取连接超时时间（毫秒）。设为 2000～5000，避免线程无限阻塞；设为 0 表示死等，生产环境禁用
-
idleConnectionTestPeriod + preferredTestQuery：启用空闲连接健康检查。设
idleConnectionTestPeriod="30"（秒），preferredTestQuery="SELECT 1"，比默认的 DatabaseMetaData 查询快得多 - maxIdleTime：空闲连接存活上限（秒）。设 1800（30 分钟），防数据库端主动断连后应用还留着“僵尸连接”
- maxConnectionAge：强制连接最大生命周期（秒）。设 3600（1 小时），防止连接长期持有可能引发的网络中间件超时或证书过期问题
容易被忽略的连接有效性保障
很多线上故障源于“拿到连接却用不了”，常见于网络波动或数据库重启后：
- 开启
testConnectionOnCheckin="true"：归还连接时验证，及时剔除失效连接 - 搭配
automaticTestTable或更轻量的preferredTestQuery，避免用 getTables 做测试（慢且可能锁表） - 如果数据库侧设置了 wait_timeout（MySQL 默认 8 小时），而应用侧 maxIdleTime 更长，就会出现“连接被 DB 关了，应用还不知道”的情况 —— 必须让 maxIdleTime ≤ wait_timeout
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
