Tomcat连接池配置未生效求助（RESTEasy+MySQL）

我之前用RESTEasy开发REST服务时，也碰到过一模一样的糟心事——明明在META-INF/context.xml里配好了连接池参数，结果MySQL上的连接数还是疯涨，各种限流设置完全没起作用。折腾大半天后，终于揪出了几个核心问题，分享给你：

1. 先确认你用的是Tomcat官方的JDBC连接池 #

很多人会不小心配错连接池类，导致Tomcat根本没用到自带的连接池管理逻辑。你得确保context.xml里的Resource标签指定了正确的数据源类：

<Resource name="jdbc/YourDB"
          auth="Container"
          type="org.apache.tomcat.jdbc.pool.DataSource" <!-- 关键是这个类 -->
          driverClassName="com.mysql.cj.jdbc.Driver"
          url="jdbc:mysql://你的数据库地址/库名"
          username="账号"
          password="密码"
          maxTotal="2"
          maxIdle="2"
          initialSize="1"
          maxWaitMillis="5000"/>

要是你之前写的是org.apache.commons.dbcp.BasicDataSource或者其他第三方池的类，哪怕参数名看起来一样，也不会被Tomcat的连接池逻辑识别，自然不生效。

2. 必须通过JNDI获取数据源，别自己硬编码创建 #

这是最容易踩的坑！要是你在RESTEasy代码里还在用DriverManager.getConnection()或者自己new连接池实例，那Tomcat的context.xml配置完全是摆设——每一次请求都会新建连接，最后直接把MySQL连接占满。

正确的做法是通过JNDI获取Tomcat管理的数据源：

第一步：在web.xml里添加资源引用 #

<resource-ref>
    <description>MySQL数据库连接</description>
    <res-ref-name>jdbc/YourDB</res-ref-name> <!-- 和context.xml里的name保持一致 -->
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

第二步：在RESTEasy代码里获取数据源 #

// 示例：在REST服务类里注入并使用
@Context
private Context context;

@GET
@Path("/test-db")
public Response testDatabaseConnection() {
    try {
        // 通过JNDI查找数据源
        DataSource dataSource = (DataSource) context.lookup("java:/comp/env/jdbc/YourDB");
        // 用try-with-resources自动关闭连接，避免泄漏
        try (Connection conn = dataSource.getConnection()) {
            return Response.ok("连接成功，当前数据源：" + dataSource.getClass().getName()).build();
        }
    } catch (NamingException | SQLException e) {
        return Response.serverError().entity("连接失败：" + e.getMessage()).build();
    }
}

3. 检查context.xml是否被Tomcat正确加载 #

有时候配置文件放错位置或者被全局配置覆盖了：

• 如果你把context.xml放在web应用的META-INF下，启动Tomcat时可以看日志，找类似Loaded context configuration from [xxx/META-INF/context.xml]的记录，确认配置被加载了。
• 另外，Tomcat的conf/Catalina/localhost/目录下如果有对应你应用名的xml文件，会覆盖你应用内的context.xml，记得检查这个文件里的配置是不是和你写的一致。

4. 验证连接池是否真的在工作 #

可以在代码里打印数据源的类名，确认用的是Tomcat的连接池：

System.out.println("当前使用的数据源类：" + dataSource.getClass().getName());

如果输出是org.apache.tomcat.jdbc.pool.DataSource，说明配置生效了；如果是其他类（比如HikariCP、DBCP），那说明你还是没用到Tomcat的连接池，得排查依赖或者配置。

按照这几步排查，基本能解决连接池参数不生效的问题。我当时就是因为图省事，代码里硬编码了连接创建，结果折腾了好久才发现😂

内容的提问来源于stack exchange，提问作者Rico