如何配置Hibernate连接Oracle的方言和驱动

小敏吖_4696

小敏吖_4696

2026-05-01

691人浏览

原创

应选Oracle12cDialect;Oracle 19c/21c仍用此方言,因其向后兼容且适配新特性;驱动须用oracle.jdbc.oracledriver,URL需匹配Service Name,方言、驱动、URL三者必须协同验证。

oracle方言和驱动必须严格匹配数据库版本,否则会出现sql生成错误、分页失效或lob字段读写异常。

Oracle方言选哪个?看实际运行的Oracle版本

Hibernate不提供通用的OracleDialect,每个版本对应一个具体实现:

  • org.hibernate.dialect.Oracle8iDialect:仅限 Oracle 8i(已淘汰,不建议)
  • org.hibernate.dialect.Oracle9Dialect 或 org.hibernate.dialect.Oracle9iDialect:Oracle 9i/10g 初期
  • org.hibernate.dialect.Oracle10gDialect:Oracle 10g R2 及以后,支持ROWNUM分页优化
  • org.hibernate.dialect.Oracle12cDialect:Oracle 12c+,支持OFFSET ... FETCH语法(但 Hibernate 5.2+ 才默认启用)
  • org.hibernate.dialect.OracleDialect 是抽象基类,不能直接用 —— 启动时会报 InstantiationException

如果你用的是 Oracle 19c 或 21c,仍应选 Oracle12cDialect;Hibernate 官方明确说明:12c 方言向后兼容 18c/19c/21c,且对 JSON、IDENTITY 列等新特性有基础适配。

驱动类名别写错:oracle.jdbc.driver.OracleDriver 已废弃

从 Oracle 10g 开始,官方推荐使用 oracle.jdbc.oracledriver(注意大小写和包路径):

  • 旧写法 oracle.jdbc.driver.OracleDriver 在 ojdbc8+ 中仍能加载,但日志会警告 DEPRECATED
  • 新写法 oracle.jdbc.oracledriver 是默认入口,支持 JDBC 4.2+ 的自动发现机制
  • 若用 Spring Boot 2.3+ + spring-boot-starter-data-jpa,可完全省略 driver_class 配置 —— ojdbc8.jar 自带 META-INF/services/java.sql.Driver

写错成 oracle.jdbc.driver.oracledriver(小写 o)或漏掉 oracle. 前缀,会导致 ClassNotFoundException 或启动卡在 DriverManager.getConnection。

QuantOracle
QuantOracle

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

下载

URL 和驱动、方言三者必须协同验证

常见组合陷阱:

  • 用 Oracle12cDialect + ojdbc6.jar:可能触发 ORA-00933: SQL command not properly ended —— 因为 ojdbc6 不识别 12c 新增的 SQL 语法标记
  • 用 Oracle10gDialect + Oracle 19c + ojdbc8.jar:分页查询仍走 ROWNUM 嵌套,无法利用 12c+ 原生 OFFSET/FETCH,性能差且 count(*) 与结果数不一致
  • hibernate.connection.url 末尾写成 @host:port:sid(如 :xe),但 Oracle 实际是 Service Name 模式(如 :ORCLPDB1):连接成功但查不到数据,因 SID 和 Service Name 在监听器中注册不同

最稳妥的验证方式:启动时加 hibernate.show_sql=true 和 hibernate.format_sql=true,执行一条简单 session.get(),观察日志里生成的 SQL 是否含 ROWNUM 或 OFFSET —— 这直接反映方言是否生效。

真正容易被忽略的是方言和驱动的“隐式耦合”:ojdbc 版本决定了底层 JDBC 行为(比如 getMetaData().getDatabaseMajorVersion() 返回值),而 Hibernate 方言初始化时会读这个值做二次适配。所以换驱动不换方言,或反过来,都可能让某些边缘 SQL(如序列取值、LOB 处理)静默失败。

相关文章

驱动精灵
驱动精灵

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

下载

相关标签:

oracle

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

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3529

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2408

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1340

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1298

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1416

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2318

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3800

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

17775

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

热门下载

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

精品课程

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