C3P0因稳定性和与旧框架兼容性仍在MySQL老项目中常见,配置需用c3p0-config.xml,必须显式指定serverTimezone、正确转义XML符号,并复用单例DataSource。

为什么 C3P0 在 MySQL 旧项目里还常见
C3P0 是 Java 早期最稳定的 JDBC 连接池之一,尤其在 Hibernate 3.x / Spring 2.x 时代被大量默认集成。它不依赖外部框架、配置项直白、异常堆栈清晰,适合维护型老项目——哪怕现在主流用 HikariCP,很多银行、政务系统仍跑着十年以上的 C3P0 + MySQL 5.1/5.5 组合。
c3p0-config.xml 中 MySQL 基础配置怎么写
必须用 c3p0-config.xml(不能叫别的名,且要放在 src/main/resources 下),否则 ComboPooledDataSource 找不到默认配置。MySQL 相关参数不能只填 jdbcUrl,否则连接会卡在握手阶段或报时区错误。
com.mysql.jdbc.Driver jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8 root 123456 5 20 5 5 0 300 30
-
serverTimezone=GMT%2B8必须显式指定,MySQL 5.7+ 默认 strict mode 下不设时区会抛java.sql.SQLException: The server time zone value '...' is unrecognized -
useUnicode=true&characterEncoding=UTF-8中的&是 XML 实体转义,写成&会解析失败 -
maxStatements=0表示禁用 PreparedStatement 缓存(C3P0 的 statement caching 有内存泄漏风险,老项目建议关掉)
Java 代码里怎么安全获取 Connection
别直接 new ComboPooledDataSource() —— 每次 new 都初始化一个新池子,导致连接数爆炸。必须复用单例实例,且注意捕获 SQLException 而非 Exception。
public class DBUtil {
private static final ComboPooledDataSource dataSource = new ComboPooledDataSource();
public static Connection getConnection() throws SQLException {
return dataSource.getConnection(); // 不要 catch,让上层决定重试 or rollback
}
}
- 如果项目用了 Spring,应改用
声明,避免手写单例出错 -
dataSource.getConnection()可能抛SQLException:连接池已满(maxPoolSize不够)、MySQL 拒绝连接(网络 ormax_connections超限)、密码过期等,不能忽略 - 老项目常漏写
connection.close(),C3P0 不会自动回收;必须放在finally或 try-with-resources 里
遇到 “Connections could not be acquired from the underlying database!” 怎么排查
这是 C3P0 最典型的报错,不是配置写错,而是底层连不上 MySQL。优先查这三处:
- 确认 MySQL 服务在运行:
systemctl status mysqld或 Windows 服务里看MySQL80是否启动 - 检查 MySQL 用户权限:用
mysql -u root -p登录后执行SELECT host, user FROM mysql.user;,确保对应用户 host 不是localhost(C3P0 默认走 TCP,需匹配127.0.0.1或%) - 查看 C3P0 日志是否开启:在
log4j.properties加log4j.logger.com.mchange.v2.c3p0=DEBUG,重点看Could not acquire a connection后面的嵌套 cause,比如Communications link failure就是网络不通
旧项目容易忽略 MySQL 的 wait_timeout(默认 28800 秒),C3P0 的 idleConnectionTestPeriod 必须小于它,否则空闲连接被 MySQL 主动断开后,C3P0 不知道,下次取出来就报错。










