讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在Tomcat中配置Oracle JNDI数据源

千墨姑娘_6047

千墨姑娘_6047

发布时间:2026-08-19 10:52:59

|

353人浏览过

|

来源于php中文网

原创

正确配置Oracle JDBC驱动需将其置于$CATALINA_HOME/lib,配合context.xml中带<Context>标签的<Resource>配置、web.xml中严格匹配的<resource-ref>声明,并在代码中用"java:comp/env/jdbc/xxx"完整路径lookup,三者任一出错均导致NameNotFoundException。

如何在tomcat中配置oracle jndi数据源

直接把 Oracle JDBC 驱动放到 $CATALINA_HOME/lib,再配好 context.xml 或 server.xml,就能用 java:comp/env/jdbc/xxx 查到数据源。别放错位置、别漏写 <context></context> 标签、别拼错 JNDI 名,这三处一错就 javax.naming.NameNotFoundException。

Oracle JDBC 驱动必须放对位置

Tomcat 7+ 不会扫描 WEB-INF/lib 里的 JDBC 驱动来初始化 JNDI 数据源——这是关键前提。驱动必须放在容器级目录:

  • $CATALINA_HOME/lib(推荐):所有应用共享,避免类加载冲突
  • 不能放 WEB-INF/lib:JNDI 初始化发生在应用加载前,此时 WebApp 类加载器还没启动
  • 注意文件名:ojdbc8.jar(Java 8+)、ojdbc6.jar(Java 6/7),旧版 classes12.zip 要重命名为 classes12.jar

context.xml 中的 Resource 配置要点

最常用的是应用级配置,在 META-INF/context.xml(打包进 WAR)或 $CATALINA_HOME/conf/Catalina/localhost/yourapp.xml(外部配置)里写:

<Context>
  <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" maxWait="10000"
    validationQuery="SELECT 1 FROM DUAL"
    testWhileIdle="true" timeBetweenEvictionRunsMillis="30000" />
</Context>

注意:

  • 必须包裹在 <Context> 标签内,否则 Tomcat 7+ 会静默忽略
  • factory 属性推荐显式指定为 org.apache.tomcat.jdbc.pool.DataSourceFactory(Tomcat 7+ 默认连接池),不写可能 fallback 到已废弃的 BasicDataSourceFactory
  • validationQuery 用 SELECT 1 FROM DUAL,不是 SELECT COUNT(0) FROM DUAL(后者语法错误)
  • url 中的 SID(如 ORCL)要和 Oracle 实例实际一致;若用 Service Name,应写成 jdbc:oracle:thin:@localhost:1521/ORCL(斜杠)

web.xml 中 resource-ref 必须严格匹配

这是最容易被跳过的一步,但缺了它,java:comp/env/xxx 就查不到:

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

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

重点:

  • <res-ref-name> 的值(如 jdbc/oracle)必须和 <Resource name="..."> 完全一致,包括大小写和斜杠
  • 这个声明只是“声明我需要一个叫这个名字的资源”,不是定义资源本身
  • 如果用 Spring,JndiObjectFactoryBean 的 jndiName 属性也得是 java:comp/env/jdbc/oracle,不能少前缀

代码中 lookup 的路径不能省略 java:comp/env

运行时获取数据源必须带完整 JNDI 命名空间:

Context ctx = new InitialContext();
DataSource ds = (DataSource) ctx.lookup("java:comp/env/jdbc/oracle");

常见错误:

  • 写成 "jdbc/oracle" → NameNotFoundException
  • 写成 "java:comp/env/jdbc/oracle/"(末尾斜杠)→ 找不到
  • 在非 Web 环境(如单元测试)里直接 new InitialContext() 会失败,因为没绑定 Tomcat 的命名上下文

真正容易被忽略的是:全局 JNDI(配在 server.xml 的 <GlobalNamingResources>)必须配合 <ResourceLink> 在应用级 context 中引用,否则应用还是看不见——这点连很多老项目都踩过坑。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4103

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

871

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1069

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5981

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2883

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5960

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7961

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1090

2024.04.29

C++运算符基础入门
C++运算符基础入门

本专题详细讲解了C++运算符的类型、语法与使用方法,涵盖算术运算符、关系运算符、逻辑运算符、位运算符、赋值运算符、条件运算符及其他特殊运算符,并通过代码示例解析优先级与结合性。

0

2026.10.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn