Spring Boot如何配置Oracle的RAC故障转移

胖宇小哥_7128

胖宇小哥_7128

2026-11-17

802人浏览

原创

Spring Boot原生不支持Oracle RAC故障转移,必须用AbstractRoutingDataSource自定义路由+健康检查+ojdbc8驱动+tnsnames.ora别名URL;仅配failover参数或FAILOVER_MODE只能实现建连时切换,连接建立后实例宕机仍报IO Error: Connection reset。

spring boot如何配置oracle的rac故障转移

Spring Boot 原生不支持 Oracle RAC 故障转移,必须靠自定义 AbstractRoutingDataSource + 健康检查 + 正确的 JDBC URL 和驱动组合实现;只配 failover=true 或依赖 TNS 层 FAILOVER_MODE,连接建立后实例宕机仍会直接报 IO Error: Connection reset。

为什么不能只靠 JDBC URL 的 failover 参数

Oracle Thin Driver 对 TAF(Transparent Application Failover)的支持有严格限制:它只在 OCI 模式下触发回调,而 Java 应用几乎全用 Thin Driver。即使你在 tnsnames.ora 里写了完整的 FAILOVER_MODE=(TYPE=SELECT)(METHOD=BASIC),JDBC URL 若是 Easy Connect 格式(如 jdbc:oracle:thin:@//rac1-vip:1521/orcl),这些参数根本不会被解析——驱动只会走最简连接路径。

  • 现象:应用连上 node1 后,node1 宕机,后续所有查询都卡住或抛 ORA-03113 / IO Error: Connection reset,不会自动切到 node2
  • 根本原因:Thin Driver 不主动监听 FAN 事件,也不在运行时重解析地址列表;TNS 层的 FAILOVER_MODE 仅作用于初始建连阶段
  • 正确做法:URL 必须引用 tnsnames.ora 别名(如 jdbc:oracle:thin:@RAC),且启动前设置 TNS_ADMIN 指向含该文件的目录

必须用 AbstractRoutingDataSource 自定义路由

Spring Boot 的 DataSource 是单例,无法感知 RAC 节点状态变化。要实现“事务开始前校验目标节点是否存活”,就得绕过默认数据源装配,自己控制路由逻辑。

  • 继承 AbstractRoutingDataSource,重写 determineCurrentLookupKey(),返回当前线程绑定的数据源 ID(如 "rac-node1")
  • 用 ThreadLocal 绑定会话级偏好,避免全局轮询导致读写分离错乱或临时表失效
  • 配合 AOP,在 @Transactional 方法入口拦截,调用 healthCheck(dataSourceId);若失败则抛 DataSourceUnreachableException 或 fallback 到备用 ID
  • 健康检查语句必须是 SELECT 1 FROM DUAL,且需捕获 SQLException 中的 ORA- 码(如 ORA-12545、ORA-03113)来判定节点不可用

ojdbc8 驱动和 URL 写法必须严丝合缝

驱动版本和 URL 格式不匹配,会导致“能连 DUAL、一跑业务 SQL 就崩”。比如 Oracle 19c RAC 下用 ojdbc6,SCAN 地址里的负载均衡信息会被静默忽略;而 ojdbc8(如 com.oracle.database.jdbc:ojdbc8:21.10.0.0)才完整支持 12c+ 的协议字段。

QuantOracle
QuantOracle

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

下载
  • JDBC URL 必须显式拼入 ?loadBalance=true&failover=true,且参数名全小写——LOAD_BALANCE=on 在 URL 里无效
  • RAC 场景禁用 oracle.jdbc.useFetchSizeWithLongColumn=true(默认开启),否则 LOB 查询可能内存溢出
  • 不要混用 UCP 的 FCF 和 TNS 层 FAILOVER_MODE:FCF 需 setFastConnectionFailoverEnabled(true) + FAN 服务端配置,二者共存会导致连接路由冲突
  • 验证方式:nslookup rac-scan.example.com 应返回三个 A 记录;连接后查 v$session 确认 machine 字段是否轮询出现在不同节点

Druid 连接池比 HikariCP 更适合 Oracle RAC 探活

HikariCP 默认的 connection-test-query 与 ojdbc8 存在隐式冲突:它可能发标准 SQL 测试语句(如 SELECT 1),但在某些驱动版本下触发 ORA-00923;而 Druid 的 validationQuery 明确适配 Oracle 语法,且 testWhileIdle=true 能在借出前拦截坏连接。

  • Druid 必配三项:validationQuery=SELECT 1 FROM DUAL、testWhileIdle=true、timeBetweenEvictionRunsMillis=60000
  • minEvictableIdleTimeMillis 设为 300000(5 分钟),防止刚建好连接就被误驱逐
  • Spring Boot 中不要同时写 spring.datasource.hikari.* 和 spring.datasource.druid.*,否则后者会被静默忽略
  • 注意:UCP 虽然官方推荐,但 Spring Boot 不支持自动装配,需手动初始化并显式调用 setFastConnectionFailoverEnabled(true)

最容易被忽略的是 TNS_ADMIN 的值——它必须是包含 tnsnames.ora 的**父目录路径**,不是文件路径;设错则驱动静默回退到 EZCONNECT 模式,所有 SCAN 和 FAILOVER_MODE 配置全部失效。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

oracle spring boot

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

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

1181

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

3533

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

3530

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

2009

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2613

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

3689

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

5009

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

257

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

966

5

热门下载

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

精品课程

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