标签必须置于Context内，仅支持META-INF/context.xml或$CATALINA_BASE/conf/context.xml，且需为直接子元素；放错位置或嵌套错误将导致javax.naming.NameNotFoundException。
context.xml里<resource></resource>标签必须放在Context内，不能塞进server.xml或web.xml
很多人把数据源配置错位置，导致应用启动时根本看不到java:comp/env/jdbc/xxx这个JNDI名。Tomcat只认META-INF/context.xml（应用级）或$CATALINA_BASE/conf/context.xml（全局级）里的<resource></resource>，且它必须是<context></context>的直接子元素。
常见错误现象：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里配<resource-ref></resource-ref>就以为完事了——那只是声明，不是定义 - 如果用全局配置，记得在
server.xml的<host></host>里确认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日志，不然连接池初始化失败你只能看到空白日志。
