部署到独立Tomcat后JDBC数据源失效问题求助

看你描述的情况，这是个很典型的环境差异问题——Eclipse内置Tomcat能跑的JNDI数据源，到了独立Tomcat就罢工，但直连的Servlet却正常。说明数据库本身没问题，问题肯定出在独立Tomcat的JNDI配置或类加载逻辑上，咱们一步步来排查：

1. 检查独立Tomcat的JNDI数据源配置 #

Eclipse内置Tomcat会自动读取项目里的META-INF/context.xml，但独立Tomcat的配置规则不一样：

• 如果你的项目里有META-INF/context.xml，打包成WAR后Tomcat会加载它，但要确保配置内容正确，比如：

  <Resource name="jdbc/YourDB" 
            auth="Container"
            type="javax.sql.DataSource"
            driverClassName="org.mariadb.jdbc.Driver"
            url="jdbc:mariadb://localhost:3306/your_db"
            username="db_user"
            password="db_pass"
            maxTotal="20"
            maxIdle="10"
            maxWaitMillis="-1"/>
  

• 更稳妥的方式是把数据源配置到独立Tomcat的conf/context.xml（全局生效）或者conf/Catalina/localhost/your_app.xml（仅你的应用生效），避免打包时配置丢失。

2. 确认MariaDB驱动在独立Tomcat的类路径里 #

直连Servlet能正常运行，大概率是你把驱动jar包打包到了WAR的WEB-INF/lib里，但JNDI数据源是Tomcat容器管理的，驱动必须放在Tomcat的lib目录下，而不是项目自身的lib文件夹：

• 把mariadb-java-client-xxx.jar复制到独立Tomcat的lib文件夹，然后重启Tomcat。
• 注意：如果WAR里也包含驱动jar，可能引发类加载冲突，建议删除WAR里的驱动，只保留Tomcat lib中的版本。

3. 验证JNDI名称的查找方式是否正确 #

Servlet里查找JNDI数据源的代码必须遵循规范的命名空间前缀：

• 正确的查找逻辑应该带上java:comp/env/前缀，比如：

  Context initCtx = new InitialContext();
  Context envCtx = (Context) initCtx.lookup("java:comp/env");
  DataSource ds = (DataSource) envCtx.lookup("jdbc/YourDB");
  

• 如果你直接写lookup("jdbc/YourDB")，Eclipse里可能碰巧能找到，但独立Tomcat严格遵循JNDI命名规则，必须加前缀。

4. 检查WAR包的配置文件完整性 #

打包后解压WAR包，确认META-INF/context.xml（如果用项目内配置的话）存在于WAR根目录的META-INF下，且内容和你本地开发时一致，避免打包过程中配置文件被遗漏或路径错误。

5. 通过Tomcat日志定位具体错误 #

如果上面的步骤都没解决问题，直接看独立Tomcatlogs目录下的localhost.log或catalina.out，日志里肯定有明确的错误提示：

• 比如ClassNotFoundException: org.mariadb.jdbc.Driver，说明驱动没在Tomcat的类路径里；
• 比如NameNotFoundException: Name [jdbc/YourDB] is not bound in this Context，说明JNDI名称配置错误或未配置。

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