mysql C3P0连接池配置方法_mysql旧项目常用方案

来源：这里教程网时间：2026-02-28 20:41:40 作者：

为什么 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

，否则连接会卡在握手阶段或报时区错误。

<?xml version="1.0" encoding="UTF-8"?>
<c3p0-config>
  <default-config>
    <property name="driverClass">com.mysql.jdbc.Driver</property>
    <property name="jdbcUrl">jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8</property>
    <property name="user">root</property>
    <property name="password">123456</property>
    <property name="initialPoolSize">5</property>
    <property name="maxPoolSize">20</property>
    <property name="minPoolSize">5</property>
    <property name="acquireIncrement">5</property>
    <property name="maxStatements">0</property>
    <property name="idleConnectionTestPeriod">300</property>
    <property name="loginTimeout">30</property>
  </default-config>
</c3p0-config>

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，应改用
<bean class="com.mchange.v2.c3p0.ComboPooledDataSource"></bean>
声明，避免手写单例出错
dataSource.getConnection()
可能抛
SQLException
：连接池已满（
maxPoolSize
不够）、MySQL 拒绝连接（网络 or
max_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 的