oracle数据源配置必须通过nacos或config server动态管理，禁止硬编码在application.yml中；@ds切换时驱动类名须为oracle.jdbc.oracledriver；config server对接oracle时properties表字段须全大写；多数据源需分别声明事务管理器。
oracle数据源配置必须走nacos或config server，不能硬编码在application.yml里
微服务上线后数据库连接信息（尤其是oracle的url、username、password）绝不能写死在本地application.yml中。否则每次换客户环境都要重新打包，违背微服务配置中心的设计初衷。
实际落地时，应将Oracle数据源参数统一抽到Nacos或Spring Cloud Config Server中管理，让服务启动时动态拉取。比如Nacos里新建Data ID为sharetek-multi-datasource-dev.yml，内容如下：
spring:
datasource:
oracle:
url: jdbc:oracle:thin:@//10.20.30.40:1521/ORCL
username: app_user
password: ${cipher:xxxxx} # 密码务必加密存储
driver-class-name: oracle.jdbc.OracleDriver
注意三点：
- url必须用jdbc:oracle:thin:@//host:port/SID格式（不是@host:port:SID），否则连不上；
- Oracle密码在Nacos中建议用${cipher:xxx}方式加密，避免明文泄露；
- Nacos配置需配合spring.profiles.active=dev和spring.cloud.nacos.config.group=DEFAULT_GROUP才能正确匹配。
@DS注解切换Oracle数据源时，驱动类名必须是oracle.jdbc.OracleDriver
使用@DS("oracle")切换数据源时，如果报java.lang.ClassNotFoundException: oracle.jdbc.driver.OracleDriver，大概率是驱动类名写错了——新版ojdbc8.jar要求用oracle.jdbc.OracleDriver，旧版才用oracle.jdbc.driver.OracleDriver（带.driver.中间段）。
检查你的pom.xml是否引入了正确版本：
<dependency><groupid>com.oracle.ojdbc</groupid><artifactid>ojdbc8</artifactid><version>21.10.0.0</version><!-- JDK 17+推荐用这个版本 --></dependency>
常见错误：
- 用com.oracle:ojdbc6配JDK 11+，直接抛Unsupported major.minor version；
- Maven中央仓库没收录Oracle驱动，必须手动mvn install:install-file导入本地jar；
- 多数据源场景下，不同数据源共用一个driver-class-name字段，但Oracle和MySQL的类名完全不同，不能复用。
Spring Cloud Config用Oracle作后端时，PROPERTIES表字段名必须全大写
如果你选Spring Cloud Config Server + Oracle做配置中心（而非Nacos），建表语句必须严格按官方要求：表名PROPERTIES、字段名KEY/VALUE/APPLICATION/PROFILE/LABEL全部大写，且主键为(KEY, APPLICATION, PROFILE, LABEL)。
否则启动时会报Invalid column name 'key'或ORA-00904: "KEY": invalid identifier。这是因为Spring Cloud Config JDBC模块默认用大写字段名查表，不支持小写或驼峰。
插入配置示例（注意APPLICATION要和微服务的spring.application.name一致）：
INSERT INTO PROPERTIES(KEY, VALUE, APPLICATION, PROFILE, LABEL)
VALUES ('spring.datasource.oracle.url', 'jdbc:oracle:thin:@//10.20.30.40:1521/ORCL', 'sharetek-multi-datasource', 'dev', 'master');
另外：
- spring.profiles.active=jdbc必须显式指定，否则默认走Git；
- Oracle连接池要用HikariCP，且connection-test-query得设成SELECT 1 FROM DUAL；
- Config Server自身也依赖Oracle驱动，所以它的pom.xml同样要加ojdbc8依赖。
多数据源+Oracle时，事务管理器必须按数据源分别声明
一旦项目里同时存在MySQL和Oracle数据源，@Transactional就不再自动生效——Spring Boot默认只配一个DataSourceTransactionManager，它只认主数据源（比如MySQL）。想对Oracle操作加事务，必须手动声明PlatformTransactionManager bean，并在service方法上显式指定@Transactional("oracleTransactionManager")。
典型写法：
@Bean("oracleTransactionManager")
public PlatformTransactionManager oracleTransactionManager(@Qualifier("oracleDataSource") DataSource dataSource) {
return new DataSourceTransactionManager(dataSource);
}
容易踩坑的地方：
- 忘记加@Qualifier("oracleDataSource")，导致注入的是默认数据源；
- 在跨库事务（比如MySQL写日志+Oracle写业务）场景下，JTA方案（如Atomikos）复杂度陡增，不建议轻易尝试；
- Oracle的savepoint行为和MySQL不同，嵌套事务回滚逻辑要单独验证。
Oracle驱动版本、表字段大小写、事务管理器绑定——这三个点任何一个出错，都会导致服务启动失败或运行时连不上库。调试时优先查日志里有没有ORA-开头的错误码，比盲目改配置高效得多。
