如何在Spring Boot 2.x中配置Oracle双数据源切换策略-Oracle-PHP中文网

优先使用 dynamic-datasource-spring-boot-starter（如3.6.1版）配置双Oracle数据源，它封装了ThreadLocal管理、@DS注解、事务兼容及连接池自动注册，避免手写AbstractRoutingDataSource在事务传播、AOP顺序、线程上下文清理等方面的高频坑。

spring boot 2.x 中配置 oracle 双数据源切换，核心不是“能不能配”，而是「路由逻辑是否隔离、事务是否可控、连接池是否独立」。直接用 abstractroutingdatasource 手写动态路由是可行的，但容易在事务传播、aop 顺序、线程上下文清理上出问题；更稳妥的做法是优先用 dynamic-datasource-spring-boot-starter，它把 threadlocal 管理、@ds 注解、事务兼容都封装好了。

为什么不用自己写 AbstractRoutingDataSource？

手写 AbstractRoutingDataSource 看似灵活，但实际踩坑密集：

determineCurrentLookupKey() 返回 null 时会 fallback 到 defaultTargetDataSource，但很多场景下你希望直接报错而不是静默降级
事务方法（@Transactional）内切换数据源无效——Spring 事务绑定的是首次获取的 Connection，后续 setDataSourceRouterKey() 不会重连
异步线程（@Async）、定时任务（@Scheduled）里 ThreadLocal 不继承，必须手动 DynamicDataSourceContextHolder.set(...) + remove()
没有内置健康检查或数据源热加载能力，新增第三个 Oracle 数据源要改代码、重启

用 dynamic-datasource-spring-boot-starter 配置双 Oracle 数据源

这是目前最省心、兼容 Spring Boot 2.1+ 的方案，支持注解级切换、默认主从标识、自动注册 Druid/Hikari 数据源。

步骤如下：

加依赖：com.baomidou:dynamic-datasource-spring-boot-starter:3.6.1（注意：3.5.0+ 支持 Oracle 12c+ 的 oracle.jdbc.driver.OracleDriver 和 oracle.jdbc.OracleDriver 自动识别）
application.yml 中定义两个 Oracle 数据源，**key 名不能含点号（.）或下划线（_）开头**，例如用 ds1、ds2，别写成 oracle.ds1 —— 否则 @DS("oracle.ds1") 会解析失败
确保每个数据源的 driver-class-name 显式指定为 oracle.jdbc.OracleDriver（JDBC 4.2+ 推荐）或 oracle.jdbc.driver.OracleDriver（旧版），避免 ClassNotFound
不需写 DynamicDataSourceAspect 切面类，starter 内置了；也不用手动调 DBContext.changeDB()，直接注解即可

示例配置片段：

QuantOracle

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

下载

spring:
  datasource:
    dynamic:
      primary: ds1
      strict: false
      datasource:
        ds1:
          driver-class-name: oracle.jdbc.OracleDriver
          url: jdbc:oracle:thin:@192.168.1.100:1521:ORCL1
          username: user1
          password: pass1
        ds2:
          driver-class-name: oracle.jdbc.OracleDriver
          url: jdbc:oracle:thin:@192.168.1.101:1521:ORCL2
          username: user2
          password: pass2

@DS 注解在 Service 层失效？检查这三点

常见现象：加了 @DS("ds2") 但查的还是 ds1；或事务方法里切不动。本质是 AOP 生效时机和代理层级问题：

注解必须加在 **public 方法** 上，private / package-private 方法不被代理
不要在同一个类内部调用带 @DS 的方法（比如 A.methodX() 调用本类的 B.methodY()），因为这是 this 调用，绕过代理
如果方法同时有 @Transactional 和 @DS，确保 @DS 切面 @Order(-1) 优先于事务切面（starter 默认已设好，但自定义切面可能覆盖）

Oracle CLOB 字段跨库查询失败？不是数据源问题，是驱动和 SQL 写法

双 Oracle 数据源本身不解决 CLOB 读写限制，但容易误判为切换失败。真实瓶颈在：

Oracle JDBC 驱动对 CLOB 的流式读取要求 connection 必须保持 open，而某些连接池（如旧版 Druid）在 query 后自动 close stream，导致 getClob().getSubString() 报 SQLException: Closed Connection
MyBatis-Plus 默认不处理 CLOB 映射，需在 @Select SQL 中显式用 TO_CHAR(col) 或配置 typeHandlers
跨库 JOIN 不被 Oracle 原生支持（DBLink 也不能查远程 CLOB），所以「双数据源切换」是唯一正解，但切换后仍要单独查、拼结果，不能写 SELECT * FROM ds1.table1 t1 JOIN ds2.table2 t2 ON ...

最后提醒一句：所有基于 ThreadLocal 的切换策略，在 WebFlux 或 Project Reactor 场景下天然失效——那是 Mono/Flux 的上下文，不是线程上下文。如果项目已上响应式栈，别碰 @DS，老实用两个独立 JdbcTemplate 实例手动控制。