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

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

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个连接，压测时瞬间打满。

性能影响很直接：设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日志，不然连接池初始化失败你只能看到空白日志。