easy connect字符串需确保names.directory_path含ezconnect、tns_admin未劫持、特殊字符url编码、端口不可省略，否则仍报ora-12154。
直接用 easy connect 字符串就能绕过 tnsnames.ora，但前提是客户端没被环境变量或注册表“劫持”去读它——否则哪怕你写了完整合法的 host:port/service_name，oracle 仍会先报 ora-12154。
sqlnet.ora 中 NAMES.DIRECTORY_PATH 必须包含 EZCONNECT
Oracle 客户端默认启用 EZCONNECT，但如果你改过 sqlnet.ora，或用了某些打包工具（如旧版 Instant Client 自带模板），可能只剩 (TNSNAMES)。此时即使字符串格式完全正确，也会跳过 Easy Connect 解析逻辑。
- 检查
$ORACLE_HOME/network/admin/sqlnet.ora（Linux）或%ORACLE_HOME%\network\admin\sqlnet.ora（Windows） - 确认存在且未被注释的行：
NAMES.DIRECTORY_PATH=(TNSNAMES, EZCONNECT)或至少NAMES.DIRECTORY_PATH=(EZCONNECT) - 如果该文件不存在，Oracle 会用内置默认值（通常含
EZCONNECT），不必强求创建
Easy Connect 字符串里哪些字符必须 URL 编码
密码或服务名中出现 @、/、:、?、空格时，不编码就会被解析器截断。例如 user/p@ss@192.168.1.10:1521/orcl 会被当成用户名 user/p、密码空、主机名 ss@192.168.1.10:1521/orcl ——必然失败。
-
@→%40，/→%2F，:→%3A，?→%3F，空格 →%20 - Windows 命令行中反斜杠
\会被 cmd 吃掉，统一换为正斜杠/或整个连接串加双引号："user/pass%40word@host:1521/svc" - 服务名开头/结尾有空格（哪怕肉眼看不见）也会触发
ORA-12154，用TRIM()或编辑器显示空白符确认
TNS_ADMIN 环境变量或注册表残留会导致 Easy Connect 失效
只要 TNS_ADMIN 指向一个含 tnsnames.ora 的目录，Oracle 就会优先尝试用它解析——哪怕你连的是 host:port/service_name 格式。这是最隐蔽的失效原因。
- Linux 下运行
echo $TNS_ADMIN；Windows 下运行echo %TNS_ADMIN%，看是否非空 - Windows 还要查注册表：
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_*下的TNS_ADMIN值（比环境变量优先级更高） - 临时禁用方法：Linux 下
unset TNS_ADMIN；Windows 下set TNS_ADMIN=（注意等号后无空格） - Java 应用需额外确认
oracle.net.tns_admin系统属性未被设值，否则 JDBC Thin 驱动也会 fallback
SQL*Plus 和 OCI 程序对端口和协议的硬性要求
Easy Connect 不是 URL，不接受 tcp:// 或 http:// 前缀，也不支持省略端口——哪怕服务监听在默认 1521，漏写 :1521 会导致整个字符串被当主机名处理，直接报 ORA-12154。
- 正确：
user/pass@192.168.1.10:1521/orcl - 错误：
user/pass@192.168.1.10/orcl（缺冒号和端口）、user/pass@tcp://192.168.1.10:1521/orcl（多前缀） - SSL 连接需加参数：
user/pass@host:2484/orcl?ssl_server_cert_dn="CN=server"，其中ssl_server_cert_dn值必须双引号包裹 - Oracle 11g 客户端对
?后参数支持不稳定，建议升级到 ojdbc8+ 或确认使用的是 11.2.0.4 及以上补丁集
真正卡住人的从来不是语法本身，而是环境里那些看不见的配置残留——尤其是 Windows 注册表里的 TNS_ADMIN 和老版本客户端静默加载的 sqlnet.ora。连不通时，先关掉所有可能干扰解析路径的东西，再试一次最简字符串 user/pass@ip:1521/service，比反复调格式更省时间。
