在Oracle RAC（Real Application Clusters）集群环境中，数据库由多个实例共同提供服务，客户端连接不能再简单指向某一个固定IP。如果沿用单实例的JDBC URL写法，一旦该节点发生故障或进行维护，应用就会直接报错，无法自动切换到健康节点。本文将结合实际配置案例，详细讲解RAC环境下JDBC连接URL的几种标准写法，并分析相关参数的含义与常见问题的排查方法。
一、RAC环境JDBC连接URL的基本格式
JDBC连接Oracle最常用的驱动是Oracle提供的thin驱动，它纯Java实现，不需要安装Oracle客户端。单实例的URL格式一般是jdbc:oracle:thin:@host:1521:SID，但在RAC环境中，这种写法并不适用，因为RAC通常使用SERVICE_NAME而非SID，且存在多个节点的地址需要同时列出。
RAC环境下的标准写法如下：
jdbc:oracle:thin:@(DESCRIPTION=
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.11)(PORT=1521))
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.12)(PORT=1521))
)
(CONNECT_DATA=
(SERVICE_NAME=orcl)
)
)
这种格式本质上就是把tnsnames.ora中的连接描述符内联到URL中。ADDRESS_LIST部分列出了集群中各节点的VIP地址，客户端会依次尝试这些地址，从而实现故障切换和负载分担。SERVICE_NAME填写的是数据库注册到监听器上的服务名，而不是某个实例的SID，这一点非常关键。在RAC中，各实例通过CRS统一对外提供service，客户端连接的是服务，而不是具体的某个实例，集群内部再根据负载情况把会话分配到不同节点。
还需要注意，HOST处填写的地址建议使用VIP（虚拟IP）而不是物理网卡的Public IP。VIP由集群软件管理，当节点宕机时，VIP会自动漂移到存活节点，保证连接请求不会因TCP超时而长时间挂起，这是RAC实现快速故障切换的基础机制之一。
二、使用SCAN地址简化连接配置
从Oracle 11.2版本开始，Oracle引入了SCAN（Single Client Access Name）机制。SCAN是集群级别的单一访问名，会在DNS或GNS中解析为最多三个IP地址。客户端只需要在URL中写SCAN地址，无需关心集群内部有几个节点、每个节点的VIP是多少。
使用SCAN的URL写法非常简洁：
jdbc:oracle:thin:@//rac-scan.ippipp.com:1521/orcl
或者写成完整描述形式：
jdbc:oracle:thin:@(DESCRIPTION=
(ADDRESS=(PROTOCOL=TCP)(HOST=rac-scan.ippipp.com)(PORT=1521))
(CONNECT_DATA=(SERVICE_NAME=orcl))
)
SCAN的最大好处是解耦。当集群扩容或缩容时，DBA增加或删除节点不需要通知应用方修改配置，SCAN会自动感知新的节点拓扑，把连接路由到正确的实例上。配合server side load balancing，SCAN监听器会根据各节点的负载情况，把新建连接转发到相对空闲的节点，实现更均衡的资源利用。
使用SCAN时有一个前提条件需要确认：客户端所在环境必须能够正确解析SCAN名称，可以通过nslookup命令验证。如果DNS中没有配置SCAN记录，也可以在客户端的hosts文件中手工添加SCAN解析，但要注意把所有SCAN IP都加上，否则负载均衡效果会打折扣。
三、FAILOVER与LOAD_BALANCE参数详解
在DESCRIPTION节点上可以附加两个重要参数：FAILOVER和LOAD_BALANCE，它们直接决定了客户端的连接行为。
jdbc:oracle:thin:@(DESCRIPTION=
(FAILOVER=ON)
(LOAD_BALANCE=ON)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.11)(PORT=1521))
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.12)(PORT=1521))
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.13)(PORT=1521))
)
(CONNECT_DATA=(SERVICE_NAME=orcl))
)
FAILOVER=ON（默认值就是ON）表示连接时如果第一个地址失败，客户端会自动尝试下一个地址。对于已建立的会话，还可以在CONNECT_DATA中配置FAILOVER_MODE实现TAF（Transparent Application Failover），节点故障时会话可以自动重连到其他节点，但TAF对DDL语句和未提交事务的保护有限，应用仍需做好异常处理。
LOAD_BALANCE=ON表示客户端在多个地址中随机选择一个发起连接，把新建会话打散到各个节点；设置为OFF则总是按顺序尝试第一个地址，只有失败才找下一个，容易造成第一个节点压力过大。实际生产中，一般推荐两者都开启，让客户端连接行为与集群的服务端负载均衡机制协同工作。
TAF的典型配置如下，METHOD参数可选BASIC和PRECONNECT，type可选SESSION和SELECT：
jdbc:oracle:thin:@(DESCRIPTION=
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.11)(PORT=1521))
(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.12)(PORT=1521))
)
(CONNECT_DATA=
(SERVICE_NAME=orcl)
(FAILOVER_MODE=
(TYPE=SELECT)
(METHOD=BASIC)
(RETRIES=3)
(DELAY=5)
)
)
)
四、连接池中的URL配置注意事项
在实际项目中，JDBC URL通常配置在Druid、C3P0、HikariCP等连接池或Spring Boot的配置文件中，此时要特别小心格式问题。
首先，长连接串必须写在一行内，或者确保配置文件支持多行折叠。例如在properties文件中，URL中的等号、括号不能被截断，写成一行是最稳妥的做法：
spring.datasource.url=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.11)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.10.12)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=orcl))(FAILOVER=ON)(LOAD_BALANCE=ON))
其次，在XML配置文件中编写这种URL时，如果描述符中出现了特殊字符，某些连接池要求使用转义形式。例如C3P0官方文档中给出的写法会把整个连接串写成<description>包裹的形式，而Druid则一般直接原样填写即可。遇到配置不生效的情况，建议先在代码中用DriverManager.getConnection直接测试URL本身是否可用，排除连接池的干扰。
另外，部分老系统还会使用TNS别名方式，即URL写成jdbc:oracle:thin:@ORCL_RAC，其中ORCL_RAC是tnsnames.ora文件里定义的别名。这种写法要求JVM启动参数中通过oracle.net.tns_admin指定tnsnames.ora所在目录，例如-Doracle.net.tns_admin=C:\oracle\network\admin。这种方式的好处是连接串集中管理，缺点是部署依赖文件环境，容器化场景下不如直接写完整URL方便。
五、常见报错与排查思路
配置RAC连接串时，最常见的报错是ORA-12505，提示SID在监听器中不存在。这个错误几乎都是因为URL用了SID写法，而RAC监听器只注册了SERVICE_NAME。解决办法是把jdbc:oracle:thin:@host:1521:orcl1这种SID形式改为SERVICE_NAME描述符形式，或者在11g之后使用斜杠语法jdbc:oracle:thin:@//host:1521/orcl，让驱动按服务名解析。
第二个常见问题是ORA-12514，监听器当前不认识请求的服务。排查时可以用sqlplus在其他机器上尝试连接，并在数据库服务器上执行lsnrctl status查看服务是否正确注册。如果服务没有注册，可能是数据库参数service_names配置有误，或者实例启动后PMON进程还没来得及向监听器注册，可以执行alter system register强制注册。
第三个问题是连接了SCAN却始终落在同一个节点上，负载不均。这通常是客户端解析SCAN时只拿到一个IP，或者中间的网络设备（如某些负载均衡器或防火墙）只转发了单个地址。排查方法是检查DNS配置和客户端解析结果，确认SCAN返回了全部三个IP地址。同时可以查询数据库视图gv$instance观察各节点的会话分布情况。
最后提醒一点，如果应用使用的是老版本的JDBC驱动连接新版本的RAC数据库，可能会遇到协议不兼容或乱码问题，建议驱动版本与数据库大版本保持一致或使用更高版本的驱动，并在URL中通过连接属性明确指定字符集，例如jdbc:oracle:thin:@.../?oracle.net.CONNECT_TIMEOUT=5000这类参数形式，充分利用驱动提供的超时控制能力，避免节点切换时出现长时间阻塞。
Oracle RACJDBC连接URL负载均衡修改时间：2026-09-01 23:58:40