ORA-12154 表示 TNS 名称解析失败，非网络问题，主因是 tnsnames.ora 未配置或 JDBC 未加载、URL 格式错误、ojdbc 版本不匹配、驱动类名误用及 Spring Boot YAML 解析异常。
ORA-12154 是 TNS 名称没找到，不是网络不通
这个错误根本不是连不上数据库，而是 tnsnames.ora 里没配对、或者 java 根本没读到它。jdbc 连接 oracle 时如果用的是 jdbc:oracle:thin:@mydb 这种带 tns 别名的写法，jvm 就会去查本地 tnsnames.ora ——但绝大多数 java 应用压根不依赖这个文件，硬要用反而容易踩坑。
- 确认你是不是真在用 TNS 别名：检查连接 URL 是否形如
jdbc:oracle:thin:@ORCL（末尾是字母名，不是 IP+端口） - 如果只是想连上，直接改用易读、可控的完整地址格式：
jdbc:oracle:thin:@//host:port/service_name或jdbc:oracle:thin:@host:port:sid -
tnsnames.ora默认只被 Oracle 客户端工具（如 sqlplus）读取；Java 的ojdbc驱动默认不加载它，除非显式设置系统属性oracle.net.tns_admin
URL 格式选 service_name 还是 sid？看 Oracle 实例类型
Oracle 12c 起默认启用了多租户（CDB/PDB），老式 sid（如 ORCL）通常指向 CDB 根，而应用该连的是 PDB 的 service_name（如 orclpdb1）。连错就报 ORA-12154 或 ORA-12505。
- 查当前实例支持的服务名：
SELECT value FROM v$parameter WHERE name = 'service_names'; - 推荐优先用
//host:port/service_name格式，兼容性更好，且能自动适配 RAC 和 PDB - 如果必须用
sid（比如 Oracle 11g 单机），确保listener.ora中SID_LIST明确注册了该 SID，且GLOBAL_DBNAME匹配 - URL 中的
host不能是localhost（尤其 Docker 或 hosts 绑定异常时），换成127.0.0.1或真实 IP 更稳
ojdbc 版本和驱动类名不匹配导致解析失败
低版本 ojdbc（如 ojdbc6.jar）不支持 //host:port/service_name 这种新 URL 格式，会静默降级或抛出模糊异常；更糟的是，有人把 oracle.jdbc.driver.OracleDriver（已废弃）和 oracle.jdbc.OracleDriver（新标准）混用，也会让连接初始化失败，间接触发 ORA-12154 类似表现。
- Oracle 12c+ 推荐用
ojdbc8.jar，对应 JDK 8+，支持所有现代 URL 形式 - 驱动类名统一用
oracle.jdbc.OracleDriver（注意包路径不含driver） - Maven 依赖别写错：
groupId是com.oracle.database.jdbc，不是旧的oracle.jdbc - 检查 classpath 是否混入多个 ojdbc 版本 —— 冲突时 JVM 可能加载了旧版，却按新版逻辑解析 URL
Spring Boot 里 application.yml 的 url 写法细节
YAML 对空格和特殊字符敏感，: 和 / 容易引发解析错误；而且 Spring Boot 的 spring.datasource.url 如果值含 @ 或 :，不加引号会被当成 YAML 键值分隔符切开。
- 务必给 URL 加单引号：
url: 'jdbc:oracle:thin:@//192.168.1.100:1521/orclpdb1' - 避免使用双引号，某些 Spring 版本会对双引号内内容做额外变量替换（比如误把
${PORT}当成占位符） - 如果 URL 含用户名密码（不推荐），也得整个包在单引号里：
'jdbc:oracle:thin:@//host:port/svc?user=foo&password=bar' - 配置后用
@PostConstruct打印dataSource.getUrl()确认实际加载的值，别只信 YAML 文件长什么样
最常被忽略的一点：ORA-12154 出现时，很多人立刻抓包看 TCP 是否通，但真正卡住的往往是 JDBC 驱动在本地解析阶段就放弃了——它甚至没发一个字节到数据库端。盯住 URL 格式、驱动版本、配置加载路径这三点，比调防火墙有用得多。
立即学习“Java免费学习笔记（深入）”；
