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

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<string></string>绑定会话级偏好,避免全局轮询导致读写分离错乱或临时表失效 - 配合 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+ 的协议字段。
- 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 配置全部失效。


















