Oracle 19c RAC的TAF生效需满足三个硬性条件:FAILOVER_MODE必须嵌套在CONNECT_DATA下、TYPE与METHOD须合理配对(推荐SESSION+BASIC)、Java应用必须通过tnsnames别名连接且驱动支持;任一缺失将导致故障时仍报ORA-03113或连接重置。
oracle 19c rac 的 taf 不是加个 failover=on 就能自动续查或秒切的。真正生效必须满足三个硬性条件:tnsnames.ora 中 failover_mode 块位置正确、type 和 method 配对合理、java 应用连接串必须引用该别名且驱动支持——漏掉任一环,故障时照样报 ora-03113 或 io error: connection reset。
tnsnames.ora 中 FAILOVER_MODE 必须嵌套在 CONNECT_DATA 下
Oracle Net 只认一种结构:FAILOVER_MODE 必须作为 CONNECT_DATA 的直接子项,不能放在 DESCRIPTION 顶层,也不能塞进 ADDRESS_LIST 里。放错位置等于没写。
- ✅ 正确写法:
(CONNECT_DATA = (SERVICE_NAME = mypdb) (FAILOVER_MODE = (TYPE = SESSION) (METHOD = BASIC))) - ❌ 错误写法:
(DESCRIPTION = (FAILOVER_MODE = ...) (ADDRESS_LIST = ...))—— 参数被静默忽略 - ❌ 错误写法:
(ADDRESS_LIST = (FAILOVER_MODE = ...) (ADDRESS = ...))—— 同样无效
TYPE 和 METHOD 必须按场景配对,不能乱选
TYPE=SELECT 和 TYPE=SESSION 行为完全不同,不是“功能更强”就该选 SELECT;METHOD=PRECONNECT 在 19c+ JDBC 中已废弃,设了也不生效。
-
TYPE=SESSION:事务中断、连接重建,适用于所有 DML 场景,兼容性最好 -
TYPE=SELECT:仅对正在执行的SELECT语句透明续跑,要求客户端支持游标保持(ojdbc8+ + 显式配置),DML 仍会报ORA-25402 -
METHOD=BASIC:连接建立时才探测备用地址,轻量可靠,19c 推荐唯一选项 -
METHOD=PRECONNECT:ojdbc8+ 已标记为不支持,设了也当没设,还可能触发ORA-12519
ADDRESS_LIST 顺序决定 failover 路径,SCAN 地址必须放第一个
TAF 不做健康检查,也不选“最快的”,它严格按 ADDRESS_LIST 从上到下尝试。第一个连得通就用,挂了才试第二个。顺序错了,可能绕到跨机房节点才切,延迟飙升。
- SCAN 地址(如
rac-scan.example.com)必须出现在第一个ADDRESS,否则 Oracle Net 解析不到后续节点 VIP,后续地址直接跳过 - 每个
ADDRESS必须独立写全:(PROTOCOL=TCP)(HOST=...)(PORT=...),不能合并 host 列表或复用 PORT - 示例正确结构:
(ADDRESS_LIST = (ADDRESS = (PROTOCOL=TCP)(HOST=rac-scan)(PORT=1521)) (ADDRESS = (PROTOCOL=TCP)(HOST=node2-vip)(PORT=1521)))
RETRIES × DELAY 决定故障感知时间,不是越大越好
从主库宕机到应用拿到新连接,耗时 ≈ RETRIES × DELAY 秒。这个值太小(如 DELAY=1)容易被监听器限流;太大(如 RETRIES=300, DELAY=10)会让应用卡住五分钟。
- 生产建议起始值:
RETRIES=180,DELAY=3→ 约 9 分钟内完成切换 -
RETRIES=0表示只试一次,失败立即报错;DELAY=0会疯狂重连,打爆监听器 - Java 应用还需额外确保:
TNS_ADMIN环境变量指向含tnsnames.ora的目录,且 JDBC URL 是jdbc:oracle:thin:@RAC(别名),不能用 Easy Connect 格式
最容易被忽略的是:TAF 生效后,正在执行的语句仍会抛出 ORA-03113 或 SQLState 08006,应用必须捕获并重试业务逻辑——TAF 只管重建连接,不管你的事务怎么续。


















