Oracle 19c客户端安装必须手动勾选SQL*Plus和Oracle Net Services，否则sqlplus报错、tnsping缺失、network/admin目录不存在；ODBC驱动需单独运行odbc_install.exe注册；TNS_ADMIN环境变量应优先设置以准确定位tnsnames.ora；Windows Server 2012 R2需在sqlnet.ora中配置SSL_VERSION=1.2或升级至19.21+版本以支持TLS 1.2。
Oracle 19c 客户端安装时选错组件会导致 sqlplus 找不到或 ORA-12154
默认安装会跳过关键命令行工具和网络配置组件，装完发现连本地 tnsnames.ora 都没法编辑，sqlplus 直接报“不是内部或外部命令”。必须手动勾选「oracle database client」下的「sql*plus」和「oracle net services」——这两项不选，客户端就是半残的。
常见错误现象：sqlplus /nolog 报系统找不到指定文件；tnsping 命令不存在；ORACLE_HOME 下没有 network/admin 目录。
- 安装类型选「自定义安装」，别点「典型」
- 组件列表里展开「Oracle Database Client」，确保勾选：
SQL*Plus、Oracle Net Services、Oracle Call Interface (OCI) - 如果只用来连接数据库（不开发），可不选
Oracle JDBC Drivers；但若用 Python 的cx_Oracle或 Java 应用，这个得勾
ODBC 驱动不会随客户端自动注册，需单独运行 odbc_install.exe
装完客户端后，在 Windows ODBC 数据源管理器里根本看不到 Oracle ODBC 驱动，不是漏装，是 Oracle 故意拆开：ODBC 支持被做成独立安装步骤，藏在客户端安装目录下。
使用场景：Excel Power Query、Tableau、旧版 VB6 程序等依赖系统级 ODBC 连接的工具。
- 进
%ORACLE_HOME%\odbc目录（例如C:\app\client\username\product\19.0.0\client_1\odbc） - 以管理员身份运行
odbc_install.exe（不运行它，驱动永远不进系统注册表） - 运行后检查
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers是否有Oracle in OraClient19Home1条目 - 32 位程序（如 32 位 Excel）要进
C:\Windows\SysWOW64\odbcad32.exe配置，64 位程序用C:\Windows\System32\odbcad32.exe—— 混用就连不上
TNS_ADMIN 环境变量比 ORACLE_HOME\network\admin 更可靠
Oracle 查找 tnsnames.ora 的路径逻辑很绕：先看 TNS_ADMIN，再找 ORACLE_HOME\network\admin，最后查注册表。很多人改了 ORACLE_HOME 却忘了同步复制配置文件，结果 tnsping 通、应用连不上。
性能影响：每次连接都扫描多个路径，设错 TNS_ADMIN 会导致连接延迟明显增加（尤其在域环境）。
- 直接设置系统环境变量
TNS_ADMIN指向一个干净目录（如C:\oracle\network） - 把
tnsnames.ora、sqlnet.ora全放进去，别依赖默认路径 - 避免在
tnsnames.ora里写相对路径或中文路径，Oracle 19c 对 UTF-8 文件名支持不稳定 - 修改后重启所有已打开的命令行窗口或服务进程，环境变量不会热更新
Oracle 19c 客户端不兼容 Windows Server 2012 R2 默认 TLS 设置
连 Oracle Cloud 或启用了 TLS 1.2+ 强制策略的数据库时，可能报 ORA-28759: failure to open file 或静默失败——不是权限问题，是客户端底层 SSL 库协商失败。
原因：Oracle 19c 客户端默认用旧版 Oracle SSL 实现，不主动升级到 TLS 1.2，而 Windows Server 2012 R2 默认禁用 TLS 1.0/1.1 后，握手直接断。
- 临时解法：在
sqlnet.ora加一行SSL_VERSION = 1.2 - 更稳做法：升级到
Oracle Client 19c Release Update 19.21及以后版本（带修复补丁） - 验证是否生效：用
tnsping连一个 TLS 数据库，抓包看 ClientHello 是否含 TLS 1.2
odbc_install.exe、环境变量没刷新，问题就会卡在你看不见的地方。
