Spring Boot连Oracle RAC必须用完整DESCRIPTION格式URL，如jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=...)(CONNECT_DATA=(SERVICE_NAME=...)))，否则因监听器无法定位实例而报ORA-12504等错。
Spring Boot连Oracle RAC必须用完整DESCRIPTION格式URL
直接写jdbc:oracle:thin:@host:port:SID或jdbc:oracle:thin:@host:port/service_name在RAC环境下基本会失败——RAC不是单点，监听器需要明确知道该把连接分发到哪个节点、是否启用故障转移和负载均衡。Spring Boot本身不解析RAC语义，全靠JDBC驱动识别DESCRIPTION结构体。漏掉任何一层括号或关键字，就会报ORA-12504、ORA-12154或连接随机超时。
- 必须用
(DESCRIPTION=...)包裹整个连接描述符，不能省略外层括号 -
ADDRESS_LIST里至少列一个ADDRESS，多个地址才能触发FAILOVER=on和LOAD_BALANCE=on -
CONNECT_DATA中必须指定SERVICE_NAME（不是SID），RAC场景下SID是实例级标识，不具备跨节点一致性 - 所有等号
=前后不能有空格，括号必须成对，YAML里若用双引号包裹URL，需确保反斜杠不被转义
多节点地址、故障转移与负载均衡参数怎么设才生效
RAC的高可用能力不是靠“写了就自动生效”，而是依赖JDBC URL里几个关键开关的实际值。比如FAILOVER=on只在连接建立失败时尝试下一个ADDRESS，但不会在运行中自动切走已建立的连接；LOAD_BALANCE=on则是在每次新建连接时轮询选择节点——这对连接池初始化和长连接生命周期影响极大。
-
FAILOVER=on：启用连接时故障转移，配合RETRY_COUNT和RETRY_DELAY可控制重试行为 -
LOAD_BALANCE=on：新建连接时按地址列表顺序轮询，不保证各节点连接数绝对均等 -
CONNECT_TIMEOUT=10：避免某个节点宕机时阻塞整个连接池初始化（默认无超时） -
TRANSPORT_CONNECT_TIMEOUT=3：TCP建连阶段超时，防止SYN包卡死
Spring Boot 3.x下RAC URL要特别注意驱动和方言匹配
Spring Boot 3强制使用Hibernate 6+，而Hibernate 6的OracleDialect默认只适配Oracle 19c+。如果你连的是12c RAC，启动虽不报错，但执行COUNT(*)、OFFSET/FETCH分页或DDL时大概率出错，日志刷HHH000511警告。这不是URL问题，但常被误判为RAC配置失败。
- 驱动必须用
com.oracle.database.jdbc:ojdbc8或更高（ojdbc11更稳），ojdbc6在JDK17+下根本加载不了OracleDriver - 显式配置
spring.jpa.database-platform=org.hibernate.dialect.OracleLegacyDialect（12c适用）或OracleDialect（19c+） - RAC服务名必须和DBA给的一致，大小写敏感；可通过
SELECT value FROM v$parameter WHERE name = 'service_names';确认 - 不要在
application.yml里用${}注入RAC URL片段——YAML缩进+变量嵌套极易破坏括号结构，建议整条URL写死或从环境变量读取字符串
验证RAC连接是否真走负载均衡？别只看启动日志
很多人改完URL就以为搞定了，结果上线后流量全打在一个节点上。RAC连接是否真正分摊，得看运行时行为，不是看Spring Boot是否启动成功。
- 在每个RAC节点上执行
SELECT inst_id, username, program FROM gv$session WHERE program LIKE '%jdbc%';，观察连接分布 - 用
HikariCP时开启data-source-properties.useUnicode=true&characterEncoding=UTF-8这类参数不影响RAC逻辑，但加了能避免某些字符集引发的隐性连接中断 - 如果应用重启后连接仍集中在一个节点，检查是否连接池设置了
maxLifetime过长，导致旧连接一直复用，新连接没机会轮询 - 最简单的压测法：起两个线程并发执行
SELECT sysdate FROM dual一百次，抓包看TCP目标IP是否交替出现
RAC配置里最容易被忽略的，是DESCRIPTION结构体内部的空格和换行——IDE自动格式化、Git换行符转换、YAML缩进都可能悄悄吃掉一个括号或等号，导致驱动静默降级为单节点模式。上线前务必用tnsping或sqlplus单独验证URL字符串是否能被Oracle客户端原样解析。
