讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

为什么Spring Boot 3连接Oracle 12c会出现驱动兼容性错误?

冬强姑娘_4544

冬强姑娘_4544

发布时间:2026-11-19 08:48:36

|

684人浏览过

|

来源于php中文网

原创

spring boot 3 默认使用 jakarta ee 9+ 规范,而 oracle 12c 官方提供的 jdbc 驱动(ojdbc8)仍基于 javax.* 包命名空间,导致类加载冲突和 noclassdeffounderror。解决此问题的核心做法是引入 spring boot 官方提供的 spring-boot-starter-data-jpa 配合 ojdbc8 的 jakarta 兼容版本,或者在构建时启用 jakarta.xml.bind 等迁移依赖。具体而言,需要在 pom.xml 中排除默认的 ojdbc 并显式声明带有 jakarta 前缀或经过迁移的驱动坐标,确保应用启动时能正确加载 oracle.jdbc.oracledriver。

为什么Spring Boot 3连接Oracle 12c会出现驱动兼容性错误?

如何配置 pom.xml 以解决 javax 与 jakarta 的包冲突?

通过替换驱动依赖坐标并添加必要的迁移库来解决包冲突。Spring Boot 3 不再支持 javax.persistence,因此必须使用适配 Jakarta 环境的驱动。在 Maven 项目中,应移除旧版 com.oracle.database.jdbc:ojdbc8,转而使用社区维护的 Jakarta 兼容版本或等待 Oracle 发布正式支持 Jakarta 的版本(如 ojdbc11 的后续更新)。同时,需确保 spring-boot-starter-data-jpa 版本为 3.x,它内部已包含对 Jakarta API 的支持。

为什么Spring Boot 3连接Oracle 12c会出现驱动兼容性错误?

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>21.9.0.0</version>
</dependency>
<!-- 若使用非官方 Jakarta 适配包 -->
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>4.0.0</version>
</dependency>

上述配置中,ojdbc8 版本 21.9.0.0 开始部分支持 Jakarta,但更稳妥的方式是使用 com.oracle.database.jdbc:ojdbc8-jakarta(如果可用)或通过 mvn dependency:tree 检查是否有 javax.* 残留。运行 ./mvnw spring-boot:run 后,观察控制台是否出现 NoClassDefFoundError: javax/persistence/Entity。若未出现,则说明包冲突已解决。预期结果是应用成功初始化 DataSource 并建立到 Oracle 12c 的连接。

QuantOracle
QuantOracle

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

下载

为什么连接 URL 需要指定 serverName 和 portNumber?

Oracle 12c 使用 TNS 别名或 Easy Connect 语法,Spring Boot 的 application.yml 中 spring.datasource.url 必须明确指定主机、端口和服务名(SID 或 Service Name)。默认情况下,Spring Boot 不会自动推断 Oracle 的网络参数,若省略这些参数,驱动会尝试连接本地默认实例,导致 ORA-12505 错误。正确的 URL 格式应为 jdbc:oracle:thin:@//host:port/service_name。此外,需设置 spring.datasource.driver-class-name 为 oracle.jdbc.OracleDriver,尽管新版驱动可自动检测,但显式声明有助于避免歧义。

为什么Spring Boot 3连接Oracle 12c会出现驱动兼容性错误?

spring:
  datasource:
    url: jdbc:oracle:thin:@//localhost:1521/orclpdb1
    username: myuser
    password: mypassword
    driver-class-name: oracle.jdbc.OracleDriver
  jpa:
    hibernate:
      ddl-auto: validate
    properties:
      hibernate:
        dialect: org.hibernate.dialect.OracleDialect

该配置文件中,url 指向本地 1521 端口的 orclpdb1 服务。运行应用时,Hibernate 将验证实体映射是否与数据库 schema 一致。若 ddl-auto 设为 validate,且表结构不匹配,应用将启动失败并抛出 SchemaManagementException。预期结果是连接池正常创建,JPA 实体管理器工厂初始化成功。若改为 update,则会自动创建缺失表,但生产环境建议保持 validate 或 none。

当 Oracle 12c 返回 ORA-00942 时,如何排查权限问题?

ORA-00942 表示“表或视图不存在”,通常由用户权限不足或模式(Schema)名称大小写不一致引起。Spring Boot 应用中,若 @Table(name="MY_TABLE") 中的名称与实际数据库中的小写表名不符,且未设置 hibernate.globally_quoted_identifiers=true,会导致查询失败。解决方法是确保实体注解中的表名与数据库中实际存在的表名完全匹配,包括大小写。若表名含特殊字符或为大写,需在 application.yml 中启用全局引号标识符,使 Hibernate 生成带双引号的 SQL,从而精确匹配 Oracle 的大写对象名。

相关文章

驱动精灵
驱动精灵

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

下载

相关标签:

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

热门AI工具

更多
DeepSeek

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

豆包大模型

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

WorkBuddy

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

相关专题

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

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

5103

2023.10.12

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

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

1031

2023.10.27

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

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

1349

2024.02.23

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

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

7201

2024.03.06

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

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

3823

2024.03.06

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

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

7180

2024.04.07

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

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

10081

2024.04.29

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

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

1370

2024.04.29

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

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

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