oracle rac的scan负载均衡需同时满足:tnsnames.ora中显式列出全部3个scan域名并置于同一address_list下、load_balance=on(小写)、dns返回3个a记录、.net驱动5.0+且启用load balance=true属性、tns_admin正确指向配置目录。

tnsnames.ora 必须显式列出全部 SCAN 地址并启用 LOAD_BALANCE=on
Oracle 客户端(包括 .NET 的 Oracle.ManagedDataAccess)不解析 DNS 轮询结果,只按 tnsnames.ora 中 ADDRESS_LIST 里写的顺序或随机方式尝试连接。只写一个 SCAN 主机名(比如 rac-scan.example.com),哪怕 DNS 返回了三个 A 记录,驱动也永远只连第一个——负载均衡完全失效。
正确写法必须是:
(RACDB =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = rac-scan1.example.com)(PORT = 1521))
(ADDRESS = (PROTOCOL = TCP)(HOST = rac-scan2.example.com)(PORT = 1521))
(ADDRESS = (PROTOCOL = TCP)(HOST = rac-scan3.example.com)(PORT = 1521))
)
(CONNECT_DATA = (SERVICE_NAME = orcl))
(LOAD_BALANCE = on)
)
)
-
LOAD_BALANCE = on必须小写on,不是true、yes或ON - 三个
ADDRESS必须包在同一个ADDRESS_LIST下,不能拆成三个独立条目 -
HOST值必须是可被 DNS 解析的 SCAN 名称,不能填 IP 或节点 VIP - 漏掉任意一个 SCAN 条目,或大小写/拼写错误,都会退化为直连第一个地址
.NET 7 中必须用 Oracle.ManagedDataAccess 5.0+ 并显式传参 loadBalance=true
仅靠 tnsnames.ora 里的 LOAD_BALANCE = on 不生效。.NET 的 Oracle 驱动需要 JDBC 风格的连接参数控制行为,且只在较新版本中完整支持。
使用示例(C#):
var connectionString = @"Data Source=RACDB;User Id=scott;Password=tiger;Connection Timeout=15;";
// 注意:必须追加 ?loadBalance=true&failover=true
var builder = new OracleConnectionStringBuilder(connectionString) {
ConnectionTimeout = 15,
LoadBalance = true, // ← 这个属性在 ODP.NET Core 5.0+ 才真正生效
Failover = true
};
- 低于
Oracle.ManagedDataAccess 5.0(对应 .NET 6+ 生态)的版本会静默忽略LoadBalance属性 - 不要用旧版
Oracle.DataAccess(已弃用),它不支持 SCAN 负载均衡逻辑 -
LoadBalance = true是属性名,不是字符串参数;若手动拼接连接字符串,需写成Data Source=RACDB;Load Balance=true;Failover=true; - 大小写敏感:
Load Balance中间有空格,且必须全小写,写成loadbalance或LOAD_BALANCE会被忽略
TNS_ADMIN 环境变量必须指向包含 tnsnames.ora 的父目录
.NET 进程启动前,必须设置 TNS_ADMIN 环境变量,且值必须是包含 tnsnames.ora 和 sqlnet.ora 的**目录路径**,不是文件路径。
例如,在 Linux 上启动服务前执行:
export TNS_ADMIN=/etc/oracle/network dotnet MyService.dll
- 设成
/etc/oracle/network/tnsnames.ora(带文件名)→ 静默失败,回退到 EZCONNECT 模式,SCAN 配置不加载 -
sqlnet.ora至少要含一行:NAME.DIRECTORY_PATH=(TNSNAMES,EZCONNECT),否则客户端根本不查tnsnames.ora - Windows 上同样适用:用
set TNS_ADMIN=C:\oracle\network,注意路径末尾不加反斜杠 - SELinux 或文件权限问题可能导致 JVM/.NET 进程读不到文件,运行用户必须对目录及其中文件有读权限
验证是否真走负载均衡:别信日志,要看 v$session.inst_id
很多团队误以为连接字符串里写了 SCAN 就自动均衡,其实只要没配对,99% 的连接都落在第一个节点上。最可靠的验证方式是直接查数据库:
SELECT inst_id, COUNT(*) FROM gv$session WHERE program LIKE '%.NET%' GROUP BY inst_id;
- 如果只有
inst_id = 1有记录,说明负载均衡完全没生效 - 常见失败原因:DNS 未返回全部三个 SCAN A 记录(用
nslookup rac-scan.example.com验证)、TNS_ADMIN设错、驱动版本太低、LOAD_BALANCE = on写错大小写 - Spring Boot 用户注意:
spring.datasource.hikari.jdbc-url必须把整个 TNS 描述符和loadBalance=true全部拼进去,不能只靠配置文件里零散参数
SCAN 负载均衡不是“开了就有效”的开关,而是客户端驱动、DNS、TNS 配置、驱动参数四者严丝合缝才能触发。任何一个环节松动,就会无声无息地退化为单点连接。











