必须用x86_64包匹配64位CentOS 7，混用i386/ia64会导致sqlplus启动失败或libclntsh.so加载错误；需用uname -m确认架构，rpm -qpl检查basic包含libclntsh，且必须设置ORACLE_HOME、LD_LIBRARY_PATH、TNS_ADMIN、NLS_LANG四环境变量并source生效。
确认安装包版本与系统架构是否匹配
64位CentOS 7必须用 x86_64 后缀的rpm包，混用 i386 或 ia64 包会导致 sqlplus 启动失败或报 libclntsh.so: cannot open shared object file。常见组合是：oracle-instantclient19.21-basic-19.21.0.0.0-1.x86_64.rpm + oracle-instantclient19.21-sqlplus-19.21.0.0.0-1.x86_64.rpm（推荐19c或21c，避免11g在新内核下偶发段错误）。
- 用
uname -m确认是x86_64 - 用
rpm -qpl *.rpm | grep libclntsh检查包里是否含核心库 - 不要跳过
basic包——sqlplus包依赖它，单独装会提示failed dependencies
安装后必须设置的四个环境变量
ORACLE_HOME、LD_LIBRARY_PATH、TNS_ADMIN、NLS_LANG 缺一不可，且顺序和路径必须严格对应实际安装位置。rpm默认装到 /usr/lib/oracle/<version>/client64/，例如19.21版就是 /usr/lib/oracle/19.21/client64。
export ORACLE_HOME=/usr/lib/oracle/19.21/client64-
export LD_LIBRARY_PATH=$ORACLE_HOME/lib（不是$ORACLE_HOME/lib:$LD_LIBRARY_PATH，否则可能加载旧版库） -
export TNS_ADMIN=$ORACLE_HOME/network/admin（tnsnames.ora必须放这里，否则sqlplus user/pass@alias找不到别名） -
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8（中文环境不设此值，SELECT中文字段会变???）
写入 ~/.bash_profile 后，务必运行 source ~/.bash_profile，仅改文件不生效。
tnsnames.ora 文件位置与最小配置格式
文件必须放在 $TNS_ADMIN 目录（即 /usr/lib/oracle/19.21/client64/network/admin），不能放错层级，也不能用软链接跨目录指向。内容不能有多余空行或 UTF-8 BOM，否则 sqlplus 解析失败，报 TNS-12154: TNS:could not resolve the connect identifier。
最简可用配置示例：
PRODUCT_DB =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.10.50)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orcl)
)
)
-
HOST填远程Oracle服务器IP，不是主机名（除非已配DNS或/etc/hosts） -
SERVICE_NAME不是SID（12c+ 默认用 service name；若连老库且不确定，可先用tnsping PRODUCT_DB测试连通性） - 别名（如
PRODUCT_DB）区分大小写，sqlplus user/pass@PRODUCT_DB必须完全一致
防火墙与SELinux导致连接静默失败的排查点
sqlplus 报 ORA-12170: TNS:Connect timeout occurred，但 telnet 192.168.10.50 1521 成功？很可能是 SELinux 阻断了 outbound 连接。
- 临时关闭验证：
setenforce 0，再试sqlplus；若恢复成功，说明是 SELinux 策略问题 - CentOS 7 默认策略不允许 oracle 客户端发起网络连接，需加规则：
setsebool -P httpd_can_network_connect 1（如果用 Apache 调用 oci8）或更准的：semanage permissive -a oracle_t（需先装policycoreutils-python） - 防火墙要放行 outbound：CentOS 7 用
firewall-cmd --permanent --add-port=1521/tcp不够，得加--add-rich-rule='rule family="ipv4" source address="192.168.10.50" port port="1521" protocol="tcp" accept'，否则 outbound 请求被 drop
真正卡住的地方往往不是 tnsnames.ora 写错，而是 SELinux 默默丢包——它不报错，只让连接超时。
