Java应用连接Oracle 19c PDB必须使用service_name（如/SALESPDB），不可用SID（如:SALESPDB），因PDB无独立实例，监听器仅注册服务名而非SID，否则报ORA-12505。
java 应用必须用 service_name（不是 sid）连接 pdb，否则必报 ora-12505。这是 oracle 19c 多租户架构的硬性约束，不是配置问题，而是设计使然——pdb 没有独立实例，也就没有 sid。
为什么 JDBC URL 里不能写 :port:SID？
传统单实例数据库中，jdbc:oracle:thin:@host:port:ORCL 能通，是因为 ORCL 是真实运行的实例 SID；但在 CDB/PDB 架构下，整个 CDB 只有一个实例（比如 ORCLCDB），所有 PDB 都跑在这个实例上。监听器注册的是服务名（service_name），不是 PDB 名作为 SID。
常见错误现象：
- 连接串写成
jdbc:oracle:thin:@192.168.1.100:1521:SALESPDB→ 报ORA-12505 - tnsnames.ora 里用
SID = SALESPDB→ 同样报ORA-12505
根本原因：监听器压根没收到这个 “SALESPDB” 的 SID 注册请求，它只认服务名。
正确 JDBC URL 格式：必须用 / + service_name
Oracle JDBC 驱动从 12c 起明确支持服务名连接，语法是 @host:port/<code>service_name（注意是斜杠 /，不是冒号 :）。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- 确认 PDB 的服务名：在 CDB 中执行
SELECT name FROM v$services WHERE pdb = 'SALESPDB';，返回值如SALESPDB.example.com或简写为SALESPDB - 最简可用连接串：
jdbc:oracle:thin:@192.168.1.100:1521/SALESPDB - 如果服务名含域名，保留全称：
jdbc:oracle:thin:@192.168.1.100:1521/SALESPDB.example.com - 不建议省略域名后缀，尤其在 RAC 或多 PDB 共存时，容易因服务名冲突导致路由错乱
tnsnames.ora 配置要匹配 service_name，不是 PDB 名
很多 DBA 习惯把 tns 别名直接起成 PDB 名，再填 SID=xxx，这在 PDB 场景下是错的。tnsnames.ora 必须指向服务名，并显式声明 SERVICE_NAME。
正确示例（保存在 $ORACLE_HOME/network/admin/tnsnames.ora）：
SALESPDB =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = db-server)(PORT = 1521))
(CONNECT_DATA =
(SERVICE_NAME = SALESPDB)
)
)
然后 Java 中可写：jdbc:oracle:thin:@SALESPDB（前提是 TNS_ADMIN 环境变量已设好）。
容易踩的坑：
- 写成
(SID = SALESPDB)→ 连接失败 - 别名和
SERVICE_NAME值不一致（比如别名叫sales，但SERVICE_NAME写成SALESPDB）→ 通常能连，但语义混乱，后续排查困难 - 未确认监听器是否已注册该服务名：执行
lsnrctl services，检查输出中是否有对应service_name条目及状态为READY
Spring Boot / HikariCP 配置要点
Spring Boot 默认用 spring.datasource.url，这里必须填服务名格式 URL：
✅ 正确写法：
spring:
datasource:
url: jdbc:oracle:thin:@192.168.1.100:1521/SALESPDB
username: salesadmin
password: Admin#1234
⚠️ 错误写法（哪怕加了 oracle.net.tns_admin）：
url: jdbc:oracle:thin:@SALESPDB # 如果 tnsnames.ora 里 SERVICE_NAME 不对，照样失败 url: jdbc:oracle:thin:@192.168.1.100:1521:SALESPDB # 冒号结尾 → ORA-12505
性能提示：服务名连接走的是动态注册路径，比静态 SID 注册更轻量，且天然支持 RAC 故障转移；但首次连接可能略慢（需监听器解析服务路由），后续连接池复用无影响。
复杂点在于：服务名不是创建 PDB 时自动“等于”PDB 名——它默认由 PDB_NAME + DB_DOMAIN 拼接而成，而 DB_DOMAIN 在 CDB 创建时就定死了。如果应用强依赖短服务名（如只要 SALESPDB），就得提前确认或修改 DB_DOMAIN，否则连出来的可能是 SALESPDB.mycompany.com，而你代码里写的却是 SALESPDB。
