TAF在.NET中必须通过服务端配置生效,ODP.NET忽略客户端FAILOVER_MODE;需用srvctl创建启用BASIC/SESSION故障转移的服务,并确保监听器注册该SERVICE_NAME,连接串仅需指向该服务名并设HAEvents=true。

TAF 在 .NET 中必须通过服务端(Service-side)配置生效,客户端连接字符串里加 FAILOVER_MODE 几乎无效 —— 因为 ODP.NET 会忽略它,且 Oracle 官方明确要求优先使用服务端配置。
ODP.NET 不支持 client-side TAF 配置
你可能会在 TNS 连接串里写类似这样的东西:
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=rac1)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=svc)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC))))
但 ODP.NET(包括最新版 23c)根本不会解析或应用这段 FAILOVER_MODE。这不是 bug,而是设计行为:Oracle 要求 TAF 必须由数据库服务本身声明能力,客户端只响应服务端下发的 failover 指令。
- ODP.NET 的
OracleConnection不读取连接描述符里的FAILOVER_MODE参数 - 即使你手动构造带 TAF 的 TNS 名,在连接时也会被静默丢弃
- 错误日志里不会报错,但
HAEvents=true也起不来 —— 因为底层没收到服务端通知
必须用 srvctl 创建带 TAF 属性的服务
服务端 TAF 是唯一可靠路径。核心动作是:用 srvctl 添加一个显式启用 TAF 的 service,并确保它注册到监听器。
- 创建服务时必须指定
-P BASIC或-P PRECONNECT(-P即FAILOVER_METHOD) - 必须用
oracle用户执行,grid用户会报PRCD-1288 - 创建后立即用
srvctl config service -d <db> -s <svc>确认输出中包含Failover type: SESSION和Failover method: BASIC - 检查监听器是否已注册该服务:
lsnrctl status | grep -A5 server_taf,看不到就说明服务没真正上线
ODP.NET 连接字符串只需指向该服务名
一旦服务端配置就绪,.NET 侧只需要最简连接串,其他全靠服务驱动:
Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=scan)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=server_taf)));User Id=scott;Password=tiger;
关键点:
-
SERVICE_NAME必须和srvctl add service里定义的完全一致(区分大小写) - 不需要写
FAILOVER_MODE,也不需要LOAD_BALANCE=true—— TAF 和负载均衡是正交功能 - 若要让连接池感知故障并剔除坏连接,必须显式开启
HAEvents=true(默认false) -
HAEvents=true依赖服务端发送的 OCI 事件,所以如果srvctl config service显示Failover type:NONE,这个参数就毫无意义
最容易被忽略的三个验证点
TAF 看似配完就跑,但实际失效常发生在这些地方:
- 服务创建后没运行
srvctl start service——config命令只显示定义,不反映运行状态 - 数据库未启用
GLOBAL_NAMES=TRUE或监听器没 reload,导致服务注册失败(lsnrctl services里看不到该 service) - 应用连接的是旧的 service(比如
ORCL),而非新创建的带 TAF 的 service(比如server_taf),连错对象自然没 TAF
真正在意 TAF 是否工作,不要看连接是否成功,而要看实例 kill 后,正在执行的 SELECT 是否中断、事务是否回滚、重连后 session 级设置(如 ALTER SESSION SET NLS_DATE_FORMAT)是否丢失 —— 这些才是 TAF 生效与否的实锤信号。


















