如何详细配置Tomcat数据源连接Oracle_JNDI资源设置？

本文共计934个文字，预计阅读时间需要4分钟。

相关专题

tomcat 连接 oracle 的 jndi 数据源配置失败，90% 是因为 ojdbc 驱动没放对位置、jndi 名字没匹配上、或 context.xml 和 server.xml 混用错层级。不是代码写错了，是部署链路断了。

Oracle JDBC 驱动必须放在 $CATALINA_HOME/lib 目录下

Tomcat 启动时由 Catalina 类加载器加载全局资源，WEB-INF/lib 里的 ojdbc8.jar（或 ojdbc6.jar）对 JNDI 数据源完全无效。驱动类 oracle.jdbc.driver.OracleDriver 或新版本的 oracle.jdbc.OracleDriver 必须能被 Tomcat 系统类加载器识别。

常见错误现象：Cannot create JDBC driver of class '' for connect url 'null' 或 ClassNotFoundException: oracle.jdbc.driver.OracleDriver

• 确认驱动文件名：Oracle 12c+ 推荐用 ojdbc8.jar；11g 可用 ojdbc6.jar；不要用 classes12.jar 这种老古董
• 路径必须是 $CATALINA_HOME/lib/ojdbc8.jar，不是 WEB-INF/lib/，也不是 $CATALINA_HOME/common/lib/（该目录在 Tomcat 7+ 已废弃）
• 删掉项目中重复的 ojdbc*.jar，避免 LinkageError 或类加载冲突

server.xml 里配全局资源，context.xml 里只做引用

全局数据源要定义在 $CATALINA_HOME/conf/server.xml 的 <GlobalNamingResources> 节点内；应用级引用则统一走 $CATALINA_HOME/conf/context.xml（全局生效）或 META-INF/context.xml（单应用生效），二者不能颠倒。

典型错误：把 <Resource> 直接写进 context.xml 却没加 factory，结果用的是默认 DBCP，但驱动参数不兼容

• 全局定义示例（server.xml）：

  <Resource name="jdbc/oracle" auth="Container" type="javax.sql.DataSource" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:orcl" username="scott" password="tiger" maxActive="20" maxIdle="10" minIdle="2" validationQuery="SELECT 1 FROM DUAL" testWhileIdle="true"/>

• 对应引用（context.xml）：

  <ResourceLink global="jdbc/oracle" name="jdbc/oracle" type="javax.sql.DataSource"/>

• 别漏掉 web.xml 中声明：

  <resource-ref> <res-ref-name>jdbc/oracle</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>

Java 代码里 lookup 必须带 java:comp/env/ 前缀

JNDI 名称不是你写在 name 属性里的字符串本身，而是容器拼接后的完整路径。写错前缀会导致 NoInitialContextException 或空指针。

容易踩的坑：开发时用 IDE（如 Eclipse）直接 run on server，实际读的是 workspace 下 Servers/Tomcat vX.X Server at localhost-config/ 里的配置，不是你本地 $CATALINA_HOME/conf/ —— 改错地方等于白改

• 正确 lookup 写法：ctx.lookup("java:comp/env/jdbc/oracle")
• 错误写法：ctx.lookup("jdbc/oracle")、ctx.lookup("java:global/jdbc/oracle")（那是 Java EE 全局命名空间）
• 调试技巧：在 servlet init() 里打印 ctx.list("")，看是否真有该名字绑定成功

最常被忽略的是验证查询（validationQuery）和连接测试时机。Oracle 不支持 SELECT 1，必须用 SELECT 1 FROM DUAL 或 SELECT SYSDATE FROM DUAL；如果设了 testOnBorrow="true" 但没配 validationQuery，连接池会静默返回坏连接。