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 配置、驱动参数四者严丝合缝才能触发。任何一个环节松动，就会无声无息地退化为单点连接。
