ORACLE_HOME、TNS_ADMIN、PATH 三者必须手动正确设置；TNS_ADMIN 必须指向独立目录（如 C:\oracle\network），不可用 ORACLE_HOME\network\admin；PATH 中 %ORACLE_HOME%\bin 需排最前；Windows Server 2012 R2 需在 sqlnet.ora 中配置 SSL_VERSION = 1.2。

ORACLE_HOME、TNS_ADMIN、PATH 这三个环境变量必须手动设置，缺一不可；否则 sqlplus 找不到、tnsping 报错、应用连不上数据库——不是装得不对，是环境没配对。

为什么不能只设 ORACLE_HOME

Oracle 查找配置文件的路径逻辑是：先看 TNS_ADMIN，再找 %ORACLE_HOME%\network\admin，最后查注册表。很多人只设了 ORACLE_HOME，却把 tnsnames.ora 放在默认目录下，结果 tnsping 能通，Java 应用或 Python 的 cx_Oracle 却报 ORA-12154。
原因：JDBC/OCI 驱动默认不读注册表，也不 fallback 到 ORACLE_HOME 下的 admin 目录，而是严格依赖 TNS_ADMIN。

TNS_ADMIN 必须指向一个干净、独立的目录

不要用 %ORACLE_HOME%\network\admin 作为 TNS_ADMIN 值——这个目录在客户端安装后可能为空，且容易被后续补丁或工具覆盖。
推荐做法：

windows-git-ops

在 Windows PowerShell 工作区执行 Git 操作时使用此技能，特别适用于创建分支、暂存、提交、合并、状态检查等。

下载

• 新建一个固定路径，如 C:\oracle\network
• 把 tnsnames.ora、sqlnet.ora 全部放进去
• 在系统环境变量中新增 TNS_ADMIN，值设为该路径（注意：不带末尾反斜杠）
• 若用 Windows Server Core（无图形界面），用 PowerShell 设置：

  setx TNS_ADMIN "C:\oracle\network" /m

  （/m 表示系统级）

PATH 要包含 %ORACLE_HOME%\bin，且顺序不能错

Windows 搜索可执行文件时按 PATH 顺序匹配。如果前面有旧版本 Oracle 的 bin 目录（比如 12c 客户端残留），就会优先调用老版 sqlplus.exe，导致连接行为异常（例如 TLS 握手失败但不报错）。

• 确认 %ORACLE_HOME%\bin 在 PATH 最前面（或至少排在其他 Oracle bin 之前）
• 检查是否有多余路径，例如 C:\app\client\olduser\product\12.1.0\client_1\bin，建议删除
• 验证方式：打开新 CMD 窗口，运行

  where sqlplus

  ，输出应唯一且指向 19c 的 bin 目录

Windows Server 2012 R2 上还要额外处理 TLS 1.2 兼容性

Oracle 19c 默认要求 TLS 1.2，而 Server 2012 R2 原生只启用到 TLS 1.0。即使环境变量全对，也会在连接时静默失败（ORA-28860 或连接超时）。

• 编辑 %TNS_ADMIN%\sqlnet.ora，加入一行：

  SSL_VERSION = 1.2

• 或者升级客户端到 19.21+ 版本（免配此项）
• 不建议全局启用 TLS 1.2 系统策略——会影响其他旧服务，精准控制在 Oracle 层更安全

环境变量本身不难设，真正容易出问题的是路径冲突、多版本共存、以及 TLS 等底层协议细节被掩盖在“连不上”的表象之下。尤其是 Server Core 或域环境中，TNS_ADMIN 设错会导致每次连接都多扫一遍注册表和多个磁盘路径，延迟肉眼可感。