Oracle多租户环境下PDB连接必须用SERVICE_NAME而非SID，JDBC URL应为jdbc:oracle:thin:@//host:port/service_name，且需确保tnsnames.ora中SERVICE_NAME与show pdbs输出的PDB_NAME严格一致。
Oracle多租户环境下PDB连接必须用SERVICE_NAME
Java微服务连不上PDB，90%是因为用了SID或ORACLE_SID方式连接。Oracle 12c+的CDB/PDB架构中，SID只标识实例（如orcl），不区分容器；真正定位PDB的是SERVICE_NAME——它在监听器中注册为独立服务名，比如pdb01、tenant-prod。
常见错误现象：ORA-12514: TNS:listener does not currently know of service requested in connect descriptor，本质是JDBC URL里填了sid=pdb01，但监听器根本没这个SID，只有service_name=pdb01。
- JDBC URL必须写成：
jdbc:oracle:thin:@//host:port/pdb01（注意双斜杠和末尾服务名） - 不能写成：
jdbc:oracle:thin:@host:port:sid或jdbc:oracle:thin:@host:port:orcl - tnsnames.ora中必须定义对应PDB的服务条目，且
SERVICE_NAME值与show pdbs输出的PDB_NAME严格一致（大小写敏感） - 验证方式：用
sqlplus /@pdb01能连上，才说明服务名已就绪
Spring Boot里AbstractRoutingDataSource路由键必须映射到PDB服务名
动态切换PDB不是切换schema，而是切换整个物理连接池——每个PDB是独立数据库实例，需要各自的数据源配置。因此AbstractRoutingDataSource.determineCurrentLookupKey()返回的key，必须是预配置的PDB服务名，而不是租户ID字符串本身。
例如：租户acme对应PDB服务名acme-pdb，那么TenantContext.getCurrentTenant()应返回"acme-pdb"，而非"acme"。否则targetDataSources.get("acme")会查不到数据源，触发lenientFallback逻辑，最终连到默认库（通常是CDB$ROOT，权限/对象都错）。
立即学习“Java免费学习笔记（深入）”；
- 推荐做法：在租户上下文初始化时，通过配置中心或本地映射表将租户ID转为PDB服务名，如
tenant-to-pdb-mapping.yml中定义acme: acme-pdb - 避免在
determineCurrentLookupKey()里做DB查询或远程调用，否则每次SQL执行都多一次网络开销 - 如果使用
dynamic-datasource-spring-boot-starter，其spring.datasource.dynamic.datasource配置块下每个子项的key必须与路由key完全一致
每个PDB必须配独立数据源，不能共享连接池
Oracle CDB下多个PDB共享一个实例进程，但彼此隔离——UNDO、TEMP、SYSTEM等表空间独立，用户、对象、权限互不可见。若强行复用同一连接池（比如所有PDB共用一个HikariDataSource），会出现“连接被其他PDB占用”或“当前容器非预期”的错误，典型报错：ORA-65046: operation not allowed from outside a container 或 ORA-01435: user does not exist（因连接在CDB$ROOT上下文中执行了PDB专属操作）。
- 每个PDB服务名需对应一个独立的
DataSourceBean，包括独立的url、username、password、连接池参数 - 不要为所有PDB共用一套用户名密码：PDB内用户是局部的（如
acme_user@acme-pdb），CDB中创建的C##公共用户在PDB中不一定有权限 - 连接池最小空闲数建议设为0，避免冷启动时大量无效连接堆积在未启用的PDB上
PDB切换后必须显式执行ALTER SESSION SET CONTAINER
即使JDBC URL已指向正确PDB服务名，某些场景下（特别是连接复用、连接池预热、或Driver版本较老），Oracle JDBC驱动仍可能在CDB$ROOT上下文中建立初始连接。此时执行SELECT * FROM DUAL看似正常，但一旦访问PDB特有对象（如DBA_TABLES或租户专属schema），就会失败。
安全做法是在获取连接后、执行业务SQL前，强制切换容器：
Connection conn = dataSource.getConnection();
conn.createStatement().execute("ALTER SESSION SET CONTAINER = " + pdbServiceName);- 该语句开销极小，仅影响当前会话，无需commit
- 务必在每次从连接池取连接后执行，不能只在首次初始化时做
- 若使用MyBatis，可通过
Interceptor统一拦截Executor.doQuery前注入该语句 - 注意：此语句仅对CDB环境有效，在非多租户Oracle中会报错，需加运行时判断
最易被忽略的一点：PDB服务名变更后，不只是改JDBC URL——所有依赖该服务名的地方都要同步，包括连接池监控指标标签、Druid控制台URL过滤规则、Prometheus采集路径、甚至日志中的数据库标识字段。漏掉任意一处，都会导致问题定位困难。
