Spring Boot连接Oracle RAC必须使用以@(DESCRIPTION=开头的TNS描述符语法，单机URL格式（如@host:port:SID）会导致DataSource初始化失败并返回null；需显式配置FAILOVER=on、LOAD_BALANCE=on，DNS须可解析SCAN域名，驱动版本不低于ojdbc8。
Spring Boot连接Oracle RAC必须用TNS描述符语法，不能套单机URL格式
直接写 jdbc:oracle:thin:@rac-scan.example.com:1521:orclcdb 会失败——oracle jdbc驱动（ojdbc8+）只在url以 @(description= 开头时才启用rac模式。否则它当普通单节点处理，datasource初始化直接返回null，日志里往往只报“failed to configure a datasource”，连连接尝试都不会发生。
关键点在于：SCAN不是IP别名，是Oracle客户端协议层的负载入口，必须走TNS嵌套结构解析。漏掉括号、写错大小写（比如 ADDRESS 写成 Address）、少一个右括号，都会导致URL静默无效。
-
HOST值必须是DNS可解析的SCAN域名（如rac-scan.example.com），不能填IP或节点VIP - 整个连接串必须包裹在
@(DESCRIPTION=...)中，不能外层再加引号或空格 - 驱动版本必须是
ojdbc8.jar或更高；ojdbc6会忽略LOAD_BALANCE和FAILOVER参数
application.properties里怎么写SCAN URL才生效
最简可用形式是：
spring.datasource.url=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=rac-scan.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLCDB))(FAILOVER=on)(LOAD_BALANCE=on))
但注意：这仅启用基础RAC能力。要真正触发负载均衡，还需追加URL参数：?loadBalance=true&failover=true（注意是小写，且&要转义）。最终完整写法：
spring.datasource.url=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=rac-scan.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLCDB))(FAILOVER=on)(LOAD_BALANCE=on))?loadBalance=true&failover=true
-
FAILOVER=on和LOAD_BALANCE=on必须显式写在TNS括号内，大小写敏感，不能写成true或yes - 不要在URL里手动列多个SCAN地址（如三个
ADDRESS）——SCAN的意义就是靠DNS返回多个A记录自动轮询，硬编码反而干扰行为 - DNS必须能从Spring Boot所在服务器解析出SCAN域名，建议用
nslookup rac-scan.example.com验证是否返回3个IP；只返回1个也能连，但负载失效
为什么加了SCAN URL还是连不上，日志却没报错
常见静默失败原因有三个：
- TNS_ADMIN环境变量未设置，或设成了文件路径（如
/etc/oracle/network/tnsnames.ora），正确值应为目录路径（如/etc/oracle/network）；设错则回退到EZCONNECT模式，SCAN配置完全不加载 -
sqlnet.ora缺失或配置错误，尤其NAME.DIRECTORY_PATH=(TNSNAMES,EZCONNECT)这一行没写，客户端根本不查tnsnames.ora - 数据库端SCAN Listener未注册服务：用
lsnrctl status LISTENER_SCAN1查看，若输出中显示 “The listener supports no services”，说明remote_listener参数为空或配置错误，需DBA执行ALTER SYSTEM SET remote_listener='rac-scan.example.com:1521'
这类问题不会抛出明确异常，只会卡在连接超时或返回空DataSource，排查必须分层验证：DNS → TNS_ADMIN目录与sqlnet.ora → SCAN Listener状态 → JDBC URL语法。
SCAN连接串里要不要配FAILOVER_MODE或RETRIES
不用。SCAN本身已内置故障转移逻辑，FAILOVER=on 已足够。额外加 FAILOVER_MODE=(TYPE=select)(METHOD=basic)(RETRIES=5)(DELAY=1) 反而可能干扰SCAN行为，尤其在12c+环境中容易引发连接延迟或重试混乱。
真正需要控制的是应用层重试策略，比如HikariCP的 connection-timeout 和 validation-timeout，或者Spring Retry对Service方法的封装。TNS层只负责把请求打到任一存活节点，后续重试应由连接池或业务代码承担。
容易被忽略的一点：SCAN域名的DNS TTL值不宜过长（建议≤60秒），否则某个SCAN IP宕机后，客户端DNS缓存可能导致长时间无法切换。
