ORACLE_HOME必须指向含bin/sqlplus、network/admin/及lib/libclntsh.so的真实安装目录，不可为软链接或聚合路径；需在bash_profile中紧邻定义ORACLE_HOME、PATH（$ORACLE_HOME/bin置首）和LD_LIBRARY_PATH，并source后用ps -ef | grep pmon和cat /proc/PID/environ验证。
ORACLE_HOME 必须指向真实安装目录，不能是软链接或上级聚合路径
oracle 19c 启动时会严格校验 $oracle_home/lib、$oracle_home/rdbms/lib 和 $oracle_home/network/admin 是否存在且可读。设错最直接的后果是：lsnrctl start 失败，但 sqlplus /nolog 看似能运行——因为 sqlplus 依赖较少，而监听器启动时会主动加载 libclntsh.so 并解析 listener.ora，这两者都必须在真实 $oracle_home 下。
常见错误路径示例：
-
/u01/app/oracle/product/19c（聚合目录，缺bin/sqlplus和network/admin） -
/u01/app/oracle/product/19c/dbhome_1的软链接（如ln -s dbhome_1 oracle_19c），Oracle 不识别符号链接路径
验证方法：用 ps -ef | grep pmon 找出正在运行的实例，看它的启动路径；再确认该路径下是否同时存在：bin/sqlplus、network/admin/listener.ora、lib/libclntsh.so（Linux）或 liboci.dll（Windows）。
bash_profile 中 export 顺序和位置决定环境变量是否真正生效
只写 export ORACLE_HOME=/opt/oracle/product/19c/dbhome_1 是不够的。如果它出现在 .bash_profile 底部，而前面已有 source ~/.bashrc 或 source /etc/profile，且这些文件里又重设了 ORACLE_HOME，那你的设置就会被覆盖。
正确做法是把三者紧邻定义：
export ORACLE_HOME=/opt/oracle/product/19c/dbhome_1-
export PATH=$ORACLE_HOME/bin:$PATH（$ORACLE_HOME/bin必须放在PATH最前面） -
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH（Linux 下 OCI 客户端程序如 Python cx_Oracle 必需，否则报libclntsh.so: cannot open shared object file）
写完后执行 source ~/.bash_profile，立刻验证：echo $ORACLE_HOME、which sqlplus、ls $ORACLE_HOME/network/admin/tnsnames.ora —— 三个都应返回预期结果。
Windows 上 ORACLE_HOME 对 Instant Client 没作用，PATH 才是关键
Oracle 19c Instant Client 是免安装版，ORACLE_HOME 不参与查找逻辑。强行设置反而可能干扰其他 Oracle 工具（比如你本地还装了完整版服务端）。
真正起效的是 PATH：
- basic 和 sqlplus 两个 ZIP 必须解压到**同一纯英文无空格路径**（如
E:\oracle\instantclient_19_29），不能各自解压出子目录 - 系统环境变量
Path中新增这一行：E:\oracle\instantclient_19_29（不带尾部\，不加引号） - 必须新开 CMD 窗口验证（旧窗口不会自动 reload
PATH） - 验证命令：
where oci.dll应返回你刚加的路径；sqlplus /nolog成功启动才算通过
若报 VCRUNTIME140.dll not found，说明缺少 VC++ 2015–2022 运行库，需单独安装。
LD_LIBRARY_PATH 在 Linux 上不是“可选”，而是 OCI 调用链的隐性开关
Oracle 19c 默认启用 runpath 机制，所以 sqlplus 自身能跑，不代表所有程序都能连。Python 的 cx_Oracle、Node.js 的 oracledb、Java 的 JDBC Thin Driver 都绕过 runpath，直接依赖 LD_LIBRARY_PATH 查找 libclntsh.so。
漏设会导致两类典型错误：
-
ORA-12154: TNS:could not resolve the connect identifier（实际是底层找不到客户端库，无法解析 tnsnames.ora） libclntsh.so: cannot open shared object file: No such file or directory
注意：LD_LIBRARY_PATH 只对 Linux 有效；AIX 用 LIBPATH，Solaris 用 LD_LIBRARY_PATH（但行为不同）。别在 Windows 上折腾这个变量。
最容易被忽略的一点：环境变量配置完，一定要检查实际进程看到的值。用 ps -ef | grep sqlplus 找到进程 PID，再执行 cat /proc/PID/environ | tr '\0' '\n' | grep ORACLE —— 这才是程序真正读到的环境，比 echo $ORACLE_HOME 更可靠。
