Tomcat context.xml配置数据库连接池 Tomcat数据源XML配置-XML/RSS教程-PHP中文网

标签必须置于Context内，仅支持META-INF/context.xml或$CATALINA_BASE/conf/context.xml，且需为直接子元素；放错位置或嵌套错误将导致javax.naming.NameNotFoundException。

tomcat context.xml配置数据库连接池 tomcat数据源xml配置

context.xml里标签必须放在`Context`内，不能塞进`server.xml`或`web.xml`

很多人把数据源配置错位置，导致应用启动时根本看不到java:comp/env/jdbc/xxx这个JNDI名。Tomcat只认META-INF/context.xml（应用级）或$CATALINA_BASE/conf/context.xml（全局级）里的，且它必须是的直接子元素。

常见错误现象：javax.naming.NameNotFoundException: Name [jdbc/mydb] is not bound in this Context，八成是放错文件或嵌套层级不对。

context.xml路径必须是WEB-INF/context.xml（旧版）或更推荐的META-INF/context.xml（优先级更高、不被war覆盖）
不要在web.xml里配就以为完事了——那只是声明，不是定义
如果用全局配置，记得在server.xml的里确认deployXML="true"（默认true，但有些定制镜像会关）

DriverClass和URL要严格匹配数据库版本，别硬套MySQL 5的写法连MySQL 8

MySQL 5.x用com.mysql.jdbc.Driver，8.x起强制用com.mysql.cj.jdbc.Driver；URL参数也变了，少了useSSL=false可能直接握手失败，多了serverTimezone=UTC才能避免时区报错。

PostgreSQL、Oracle同理：驱动类名和URL格式稍有偏差，连接池就卡在getConnection()不返回，日志里只打“Connection refused”这种误导信息。

MySQL 8示例URL：jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
PostgreSQL驱动类：org.postgresql.Driver，URL以jdbc:postgresql://开头，别漏://
Oracle Thin驱动类：oracle.jdbc.driver.OracleDriver（12c+建议用oracle.jdbc.OracleDriver），URL里:@之间必须是//host:port/service_name格式

maxActive已废弃，Tomcat 8.5+必须用`maxTotal`和`maxIdle`

老教程里满屏的maxActive="20"在Tomcat 8.5+（即使用commons-dbcp2或tomcat-jdbc 8.5+）里完全无效，实际生效的是maxTotal。用错参数名不会报错，但连接池永远只维持1个连接，压测时瞬间打满。

Bertha.ai

一款专为WordPress内容创作设计的AI工具，可在网站编辑环境中辅助生成文章、文案和图片内容，提高站点内容生产效率。

下载

性能影响很直接：设maxTotal="5"却并发10请求，后5个全卡在获取连接上，响应时间陡增，你以为是SQL慢，其实是池子没水。

关键参数对应关系：maxActive → maxTotal，maxIdle → maxIdle，minIdle → minIdle，removeAbandonedTimeout → removeAbandonedOnBorrow（注意是布尔值）
testOnBorrow="true"加validationQuery="SELECT 1"能防失效连接，但别在高并发场景开——每次取连接都查一次库，开销不小
Oracle建议用validationQuery="SELECT 1 FROM DUAL"，MySQL用"SELECT 1"即可

JNDI lookup写法必须带`java:comp/env/`前缀，Spring Boot项目容易漏掉

纯Servlet项目里用new InitialContext().lookup("java:comp/env/jdbc/mydb")没问题，但Spring Boot默认不启用JNDI，如果只在application.properties里写spring.datasource.jndi-name=java:comp/env/jdbc/mydb，却不加spring.main.web-application-type=SERVLET，就会静默 fallback 到本地HikariCP，完全绕过Tomcat连接池。

更隐蔽的坑：IDE里Run as Server能连上，打包成war丢到生产Tomcat却报NPE——因为开发时IDE内置Tomcat没读你的META-INF/context.xml，用的是自己配的内存池。

Spring Boot中必须显式启用JNDI：spring.datasource.jndi-name=java:comp/env/jdbc/mydb + spring.main.web-application-type=SERVLET
Java EE项目里，@Resource(name = "java:comp/env/jdbc/mydb")的name值不能省略前缀，也不能写成jdbc/mydb
调试时用new InitialContext().list("java:comp/env")能直接看到当前上下文注册了哪些JNDI名

最常被忽略的其实是验证环节：改完context.xml必须重启Tomcat，光重发war不行；而且log4j2.xml或logging.properties里得打开org.apache.tomcat.jdbc.pool的DEBUG日志，不然连接池初始化失败你只能看到空白日志。