如何解决Oracle驱动的ClassNotFoundException_检查classpath

陌枫酱_5261

陌枫酱_5261

2026-04-10

1037人浏览

原创

Oracle JDBC驱动加载失败的直接原因是Class.forName找不到oracle.jdbc.driver.OracleDriver类,本质是驱动JAR未正确进入运行时classpath或版本/路径不匹配,JDK 9+还受模块系统影响。

Oracle JDBC驱动没加载成功,Class.forName报错

直接原因是 jvm 找不到 oracle.jdbc.driver.oracledriver 类,本质是驱动 jar 没进 classpath,或进了但版本/路径不对。jdk 9+ 还可能因模块系统导致类不可见。

确认驱动 JAR 是否真在 classpath 里

别只看 IDE 的“Libraries”列表——它可能没同步到运行时 classpath。实际验证方式只有两个:

  • 启动 Java 进程时加 -verbose:class,观察日志里有没有类似 [Loaded oracle.jdbc.driver.OracleDriver from file:/.../ojdbc8.jar]
  • 运行时打印:System.out.println(System.getProperty("java.class.path"));,然后手动检查输出路径下是否存在 ojdbc8.jar(或对应版本)

常见坑:Maven 项目里写了 <scope>provided</scope> 却没配容器;Spring Boot 打成 jar 后,ojdbc*.jar 没放进 lib/ 目录或没用 spring-boot-maven-plugin 正确打包。

用对驱动类名,且注意 JDK 版本兼容性

Oracle 12c 及以后推荐用新类名:oracle.jdbc.OracleDriver(不是旧的 oracle.jdbc.driver.OracleDriver),后者在 ojdbc8+ 中已废弃,仍能用但会打警告日志;JDK 11+ 若用老类名 + ojdbc7,可能直接抛 ClassNotFoundException。

QuantOracle
QuantOracle

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

下载

实操建议:

  • 优先写 Class.forName("oracle.jdbc.OracleDriver")
  • 确认 JAR 名匹配:ojdbc8.jar → 对应 JDK 8–11;ojdbc11.jar → JDK 11+;别把 ojdbc6.jar 丢进 JDK 17 环境
  • Tomcat 等容器中,把 JAR 放 $CATALINA_HOME/lib,别放 WEB-INF/lib(否则可能因 WebAppClassLoader 隔离而找不到)

Spring Boot 项目里 driver-class-name 配错

application.yml 中写错会静默失败或启动报 Failed to load driver class:

  • 必须写全限定名:spring.datasource.driver-class-name: oracle.jdbc.OracleDriver
  • 别漏掉 oracle. 前缀,写成 jdbc.OracleDriver 就会崩
  • 如果用 HikariCP,还要确保 spring.datasource.hikari.driver-class-name 和上面一致(否则以 Hikari 配置为准)
  • 使用 Spring Boot 3.x + Jakarta EE 9+ 时,确认依赖是 com.oracle.database.jdbc:ojdbc11,而非老的 com.oracle.ojdbc:ojdbc8(包名不同,类路径也不同)

最易被忽略的一点:本地开发用 IDE 运行时 classpath 正常,但打包成 fat jar 后,ojdbc*.jar 如果没被 Maven 插件正确嵌入(比如用了 system scope 或手动 copy),生产环境必然报 ClassNotFoundException —— 这个问题不会在 IDE 里暴露。

相关文章

驱动精灵
驱动精灵

驱动精灵基于驱动之家十余年的专业数据积累,驱动支持度高,已经为数亿用户解决了各种电脑驱动问题、系统故障,是目前有效的驱动软件,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

oracle

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.10.12

4423

8

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

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

2023.10.27

931

4

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

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

2024.02.23

1169

5

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

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

2024.03.06

6361

10

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

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

2024.03.06

3183

4

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

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

2024.04.07

6340

11

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

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

2024.04.29

8641

6

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

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

2024.04.29

1170

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1032

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程