必须在~/.bash_profile中定义ORACLE_HOME等变量,且路径须真实、无软链接、权限正确,PATH和LD_LIBRARY_PATH需前置,TNS_ADMIN和NLS_LANG格式须规范,否则导致lsnrctl失败、ORA-12705或共享库加载错误。

必须在 ~/.bash_profile 中定义,且顺序、路径、权限三者缺一不可;设错会导致 sqlplus 可运行但 lsnrctl 启动失败、ORA-12705 报错或共享库加载失败。
为什么不能用 ~/.bashrc?
Oracle 用户登录时只读取 ~/.bash_profile(除非你显式 source ~/.bashrc)。很多用户把变量写进 ~/.bashrc,然后反复 source ~/.bashrc 测试——这能临时生效,但换终端或 su - oracle 后就失效。根本原因是:Linux 的 login shell 默认不加载 ~/.bashrc。
- 验证方式:
su - oracle -c 'echo $ORACLE_HOME',如果为空,说明没走~/.bash_profile - 安全做法:只在
~/.bash_profile里写,删掉~/.bashrc中重复的export ORACLE_HOME - 不要在
/etc/profile或/etc/bash.bashrc里全局设置,会干扰其他用户或工具
ORACLE_HOME 路径必须真实、可执行、无软链接
Oracle 19c(及 12c/18c)启动监听器、连接数据库时,会严格检查 $ORACLE_HOME/lib、$ORACLE_HOME/network/admin 和 $ORACLE_HOME/bin/sqlplus 是否存在且当前用户有 x 权限。常见错误包括:
- 路径末尾多斜杠:
/u01/app/oracle/product/19c/dbhome_1/❌ → 应为/u01/app/oracle/product/19c/dbhome_1✅ - 指向聚合目录:
/u01/app/oracle/product/19c❌(里面没有bin/或network/admin/) - 用了软链接:
ln -s dbhome_1 oracle_19c,再设ORACLE_HOME=/u01/.../oracle_19c❌(Oracle 不解析符号链接) - 权限不足:
ls -ld $ORACLE_HOME显示无x位 → 导致error while loading shared libraries
验证命令:cd $ORACLE_HOME && ls bin/sqlplus network/admin/tnsnames.ora lib/libclntsh.so 2>/dev/null || echo "missing critical files"
PATH 和 LD_LIBRARY_PATH 必须前置且紧邻定义
顺序错了,$ORACLE_HOME/bin 就可能被系统自带的老版本 sqlplus 覆盖;LD_LIBRARY_PATH 没设或位置靠后,Python 的 cx_Oracle 或 Java 的 JDBC 就会报 libclntsh.so: cannot open shared object file。
export ORACLE_HOME=/u01/app/oracle/product/19c/dbhome_1-
export PATH=$ORACLE_HOME/bin:$PATH($ORACLE_HOME/bin必须在最前) -
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH(Linux 必须,Windows 不需要) - 三行必须连续,中间不要穿插
source ~/.bashrc或其它export
生效后立即验证:which sqlplus 应返回 $ORACLE_HOME/bin/sqlplus;echo $LD_LIBRARY_PATH | grep "$ORACLE_HOME/lib" 应命中。
TNS_ADMIN 和 NLS_LANG 是高频踩坑点
TNS_ADMIN 不设也行,但一旦设了就必须指向含 tnsnames.ora 和 sqlnet.ora 的目录;NLS_LANG 不设常导致中文乱码或 ORA-12705(“Cannot access NLS data files”)。
-
TNS_ADMIN示例:export TNS_ADMIN=$ORACLE_HOME/network/admin(默认路径,可省略)或export TNS_ADMIN=/etc/oracle/tns(自定义路径,需确保该目录下有tnsnames.ora) -
NLS_LANG值格式固定:Language_Territory.Characterset,例如:export NLS_LANG=AMERICAN_AMERICA.AL32UTF8 - 别写成
export NLS_LANG=AL32UTF8或export NLS_LANG=zh_CN.UTF-8—— Oracle 不识别这种格式 - 验证:
sqlplus /nolog→SELECT * FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';,对比客户端与服务端字符集
真正容易被忽略的是:即使所有变量都设对了,如果 $ORACLE_HOME/network/admin 下没有 sqlnet.ora,某些网络认证场景仍会静默失败——建议至少放一个空文件占位。


















