如何在Spring Boot中配置Oracle 19c RAC的UCP连接池-Oracle-PHP中文网

ucp连接池必须显式调用setfastconnectionfailoverenabled(true)启用fcf，仅设oracle.jdbc.fanenabled=true无效；fcf依赖服务端fan、ons连通性及service名精确匹配，缺一不可。

如何在spring boot中配置oracle 19c rac的ucp连接池

UCP连接池必须显式启用FCF，`setFastConnectionFailoverEnabled(true)`不能省

Spring Boot启动后，UCP默认不监听FAN事件，哪怕RAC service已启用FAILOVER_TYPE=SELECT、ONS连通性正常、JDBC URL里写了oracle.jdbc.fanEnabled=true，连接池照样对节点宕机无感。常见现象是应用持续向已下线的RAC实例发请求，报ORA-03113或IO Error: Connection reset，重试间隔长达20–30秒。

解决办法只有一个：在PoolDataSource初始化完成后，立刻调用setFastConnectionFailoverEnabled(true)。这个动作不能靠配置项自动触发，也不能放在setConnectionProperties里传——UCP根本不从那里读这个开关。

若用@Bean方式定义PoolDataSource，需在方法末尾手动调用该方法
若集成Spring Boot，推荐用@PostConstruct或实现InitializingBean.afterPropertiesSet()来确保执行时机
验证是否生效：启停一个RAC节点，观察日志中是否有UCP: FCF event received for service类消息

tnsnames.ora里禁用`FAILOVER=ON`和`LOAD_BALANCE=ON`，只留基础描述符

FCF（快速连接故障转移）和TNS层的FAILOVER_MODE逻辑互斥。两者共存会导致路由混乱：FCF主动清理坏连接，而TNS又在地址列表里轮询重连，结果连接卡死在已下线节点上不动。

正确做法是彻底删除FAILOVER=ON、LOAD_BALANCE=ON、整块FAILOVER_MODE配置，只保留最简结构：

(DESCRIPTION=
  (ADDRESS=(PROTOCOL=TCP)(HOST=myrac-scan)(PORT=1521))
  (CONNECT_DATA=(SERVICE_NAME=my_service))
)

JDBC URL必须用SCAN地址或tnsnames别名，例如jdbc:oracle:thin:@MYRAC，严禁用Easy Connect格式（如jdbc:oracle:thin:@//rac1-vip:1521/my_service）
确保TNS_ADMIN环境变量指向含该tnsnames.ora的目录，否则UCP根本不会加载它
FCF依赖服务端FAN和ONS通路，务必提前用onsctl ping -h rac1-vip -p 6200验证

连接亲和性靠`connectionLabel`控制，不是URL或池参数

Oracle UCP的连接亲和性（Connection Affinity）本质是“把带相同标签的请求尽量复用同一物理连接”，用于维持临时表、包变量等会话级状态。它不等于负载均衡，也不靠修改JDBC URL或池配置就能生效。

QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载

实际使用时，每次获取连接前要设置label：

Connection conn = pds.getConnection();
conn.setClientInfo("affinity", "user_123");
// 或更常用：用UCP的connectionLabel机制
pds.setConnectionLabelingCallback(new MyAffinityCallback());

MyAffinityCallback需实现ConnectionLabelingCallback接口，根据业务上下文（如用户ID、租户ID）返回label键值对
label值必须是字符串，且建议控制长度（避免内存膨胀），不要塞JSON或长token
注意事务边界：跨事务的label复用可能导致状态污染，尤其在使用@Transactional时要小心