标签必须置于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个连接,压测时瞬间打满。
SHOPEX简灰服装商城整站源码下载。 安装方法:1.解压上传程序至网站根目录.. 访问:域名/bak.(用户名:admin 密码:123456)2.进入帝国备份王后,配置数据库数据库信息.选择-www.taomoban.net目录.还原数据库.3.修改FTP目录下的config/config.phpphp 数据库连接信息.4.登陆网站后台--清空缓存..5.删除bak文件夹 后台:shopadm
性能影响很直接:设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日志,不然连接池初始化失败你只能看到空白日志。









