Spring Boot连接Oracle RAC必须使用SCAN域名+TNS描述符语法，单机格式（@host:port:SID）无法识别SCAN，导致DataSource初始化失败并返回null；标准URL需以@(DESCRIPTION=开头，显式配置LOAD_BALANCE=on、FAILOVER=on，并确保DNS可解析SCAN域名。
spring boot 连接 oracle rac 时，用 scan 地址比写死多个 vip 更可靠、更易维护 —— 但直接照搬单机 url 格式或乱配参数，datasource 就会返回 null，连不上。
为什么不能用单机格式写 SCAN 连接串
单机 URL 是 jdbc:oracle:thin:@host:port:SID，而 SCAN 必须走 Oracle 的 TNS 描述符语法（即括号嵌套结构），否则驱动压根不识别。Spring Boot 启动时解析失败，DataSource 初始化失败，日志里可能只显示 “Failed to configure a DataSource”，实际根本没进连接逻辑。
- Oracle JDBC 驱动（
ojdbc8.jar及以上）只在 URL 以@(DESCRIPTION=...开头时才启用 RAC 模式 - 漏掉
ADDRESS_LIST或写成ADDRESS（少下划线）会导致解析失败，静默跳过 - 把
SCAN_NAME写成 IP 地址 + 端口（如@192.168.3.231:1521）等同于单节点直连，完全绕过 SCAN 负载和故障转移
application.properties 中 SCAN URL 的标准写法
核心是：用 DNS 解析的 SCAN 域名（如 rac-scan.example.com），不是 IP；整个 URL 必须包裹在括号描述符中；LOAD_BALANCE=on 和 FAILOVER=on 必须显式开启，否则默认不启用 RAC 特性。
- 最简可用形式：
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)) - DNS 必须能从 Spring Boot 所在服务器解析出至少一个 SCAN IP（建议配置 3 个，但即使只解析出 1 个也能连，只是失去负载能力）
- 不要在 URL 里写多个
ADDRESS—— SCAN 的意义就是由一个域名背后自动轮询多个 IP，写多个反而干扰 SCAN 行为 -
SERVICE_NAME必须与 RAC 实例注册的服务名一致（不是 SID），可通过srvctl config service -d <db_name>查看
常见报错 DataSource returned null 的真实原因
这不是数据库拒绝连接，而是 Spring Boot 根本没创建出 DataSource 实例 —— 通常因为驱动加载失败、URL 格式非法、或关键属性缺失。
-
java.sql.SQLException: No suitable driver：检查是否引入了ojdbc8（非ojdbc6），且未被其他依赖（如 HikariCP 旧版）排除 - 启动日志出现
Unable to determine embedded database driver class for database type NONE：说明spring.datasource.url未被正确读取，大概率是 YAML 缩进错误或 properties 中用了中文冒号 - 连接超时但无明确异常：DNS 解析慢或失败，可在应用服务器上执行
nslookup rac-scan.example.com验证；若返回空或超时，DataSource初始化会卡住并最终失败 - 使用
/etc/hosts强制映射 SCAN 域名 → 单 IP：虽能连通，但彻底失去 SCAN 的多 IP 轮询和故障转移能力，等于退化为单点连接
SCAN 连接必须配合的两个配置项
只写对 URL 不够，driver-class-name 和连接池超时策略必须同步调整，否则即使 URL 正确，连接也会在高并发或节点故障时卡死或反复重试。
-
spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver（ojdbc8仍兼容此类名；若用ojdbc11，可改用oracle.jdbc.OracleDriver，但非必需） -
spring.datasource.hikari.connection-timeout=30000：避免因某节点不可达导致连接池线程长时间阻塞，默认 30 秒较稳妥 -
spring.datasource.hikari.validation-timeout=3000：健康检查超时设短些，加速故障节点剔除 - 不要设
spring.datasource.hikari.maximum-pool-size过大（如 > 50）—— RAC 的 SCAN listener 本身有连接队列限制，盲目扩池反而引发拒绝连接
SCAN 的本质是 DNS 层的负载入口，不是客户端的负载算法。真正起作用的是 Oracle 数据库端的 SCAN Listener 和 Local Listener 协同转发，客户端唯一要确保的，就是 URL 格式合法、DNS 可达、驱动支持、连接池不卡死 —— 其余都交给 Oracle 集群自己处理。
