c3p0-config.xml 是 c3p0 连接池使用的外部 XML 配置文件，用于声明数据源连接参数与池行为，需置于 classpath 根目录且文件名严格为 c3p0-config.xml，否则静默回退默认配置。
什么是 c3p0-config.xml
c3p0-config.xml 是 c3p0 连接池库使用的**外部 XML 配置文件**，用于声明数据源（ComboPooledDataSource）的连接参数、池行为、超时策略等。它不是 Java 代码硬编码配置的替代品，而是把原本写死在 new ComboPooledDataSource() 中的 setXXX() 调用，抽离成可独立维护的 XML 文件。
注意：c3p0 自 0.9.5 起已停止维护，官方明确建议迁移到 HikariCP 或 Druid；但老项目中仍常见该配置，理解它对维护和迁移有实际意义。
c3p0-config.xml 的标准位置与加载规则
c3p0 默认只在 classpath 根目录下查找名为 c3p0-config.xml 的文件（即 src/main/resources/c3p0-config.xml）。文件名**不能带版本号或前缀**，也不能放在子目录里——否则 ComboPooledDataSource 构造时会静默回退到默认配置（如初始连接数为 3、最大连接数为 15），不报错也不提示缺失。
常见误操作：
- 把文件放在
resources/config/下 → 不生效 - 命名为
c3p0-config-dev.xml→ 不生效 - 用
FileInputStream手动加载但路径错误 → 抛IOException
核心配置项与易错参数
一个最小可用的 c3p0-config.xml 必须包含
关键参数差异和坑点：
-
acquireIncrement：每次连接不足时“补多少”，不是“最小空闲数”——设太大容易瞬间打满数据库；设太小（如 1）可能频繁触发获取，影响吞吐 -
maxIdleTime：连接空闲多久后被回收（秒），**不是毫秒**；设为 0 表示永不过期，但数据库端通常有 wait_timeout（MySQL 默认 28800 秒），会导致连接被服务器主动断开 -
testConnectionOnCheckout：每次从池取连接前执行 SELECT 1，**严重拖慢性能**，仅调试用；生产应改用idleConnectionTestPeriod+connectionTesterClassName -
driverClass必须是完整类名，如com.mysql.cj.jdbc.Driver（MySQL 8+），写成com.mysql.jdbc.Driver在新驱动下会 ClassNotFound
com.mysql.cj.jdbc.Driver jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC root 123456 2 5 5 20 1800 300
Java 中如何正确加载并使用
直接 new ComboPooledDataSource() 即可自动加载 classpath 下的 c3p0-config.xml；若用了具名配置（new ComboPooledDataSource("prod")。
常见错误现象：
- 程序启动无报错，但 SQL 执行时报
SQLException: Connections could not be acquired→ 检查jdbcUrl是否含非法字符（如未转义的&），XML 中需写成& - 连接池始终只有 3 个连接 → 忘记设
initialPoolSize，c3p0 默认值就是 3 - 日志里反复出现
[c3p0] A PooledConnection that has already signalled a Connection error is still in use!→testConnectionOnCheckout开启但数据库不可达，或网络不稳定
真正容易被忽略的是：c3p0 的配置解析不校验 XML 结构合法性，拼错标签名（如 drvierClass）会导致对应参数完全失效，且无任何警告——你得靠观察运行时行为（比如连接数没按预期增长）反推问题。
