ld_library_path配置错误是instant client连接oracle 19c失败的首要原因，必须精确指向解压目录下的lib子目录（如/path/to/instantclient_19_19/lib），而非根目录，否则系统无法定位libclntsh.so；同时需安装libaio和libnsl，并通过ldconfig -p | grep clntsh验证生效。
LD_LIBRARY_PATH 没设对，libclntsh.so 就找不到
Linux/macOS 下运行 oci_new_connect() 或 cx_Oracle.connect() 时抛出 libclntsh.so: cannot open shared object file，本质是动态链接器压根没去你放 Instant Client 的目录里找库。不是文件不存在，而是路径没告诉系统。
- 先确认文件真在：运行
ls -l /path/to/instantclient_19_19/libclntsh.so*，看有没有带版本号的软链接（如libclntsh.so.19.1）且指向真实文件 - 临时验证：执行
export LD_LIBRARY_PATH=/path/to/instantclient_19_19:$LD_LIBRARY_PATH，再跑程序；如果这时好了，说明就是路径问题 - 永久生效别改
/etc/ld.so.conf—— 改用/etc/ld.so.conf.d/oracle.conf写入路径，然后运行sudo ldconfig - 注意路径拼写：比如解压出来是
instantclient_19_19，但环境变量写成instantclient_19_20，就会静默失败
Windows 上 oci.dll 找不到，多半是 PATH 或位数错
Navicat/PL/SQL Developer 报“无法加载 oci.dll”或“Oracle library is not loaded”，常见于绿色版工具，根源是 Windows 加载器搜不到 DLL，或找到后因架构不匹配被拒载。
- 检查
%PATH%是否包含 Instant Client 解压目录：在命令行运行echo %PATH% | findstr "instantclient" - 位数必须严格一致：64 位 Navicat 必须配 64 位 Instant Client（
instantclient-basic-windows.x64-*.zip），混用 32/64 位会报“找不到指定模块” - 依赖项不能少：Instant Client 依赖 Microsoft Visual C++ Redistributable（如 vc_redist.x64.exe），没装会导致
oci.dll初始化失败 - 路径别含中文或空格：Navicat 配置 OCI 环境时填的路径，如果像
D:\我的软件\instantclient_21_4，很可能加载失败
Docker 容器里 LD_LIBRARY_PATH 不生效？进程启动顺序错了
OCI8 扩展 php -m 显示已加载，但 oci_new_connect() 返回 false 且无错误，Docker 中极大概率是 LD_LIBRARY_PATH 没在 PHP 进程启动前生效。
-
ENV LD_LIBRARY_PATH=/opt/oracle/instantclient_21_4:$LD_LIBRARY_PATH必须写在 Dockerfile 中靠前位置（比如基础镜像之后、安装 PHP 扩展之前） - 不要只靠
/etc/ld.so.conf.d/+ldconfig：PHP-FPM 或 Apache 子进程可能因非 root 用户启动而无法继承系统级配置 - 验证是否生效：进容器执行
php -r "echo getenv('LD_LIBRARY_PATH');"，输出应包含 Instant Client 路径 - Docker Compose 启动时用
environment:覆盖，要确保该变量传给了实际执行 PHP 的用户（如www-data）
Python cx_Oracle 报 DPI-1047，其实和 libclntsh.so 是一回事
DPI-1047: Cannot locate a 64-bit Oracle Client library 看似 Python 错误，底层仍是操作系统找不到 libclntsh.so（Linux/macOS）或 oci.dll（Windows）。
- macOS 注意 dylib 路径：错误提示里出现
dlopen(libclntsh.dylib, ...)，说明 Python 尝试从/usr/local/lib/找，但 Instant Client 解压在别处，得设LD_LIBRARY_PATH或DYLD_LIBRARY_PATH - Linux 必装
libaio：运行yum install libaio或apt-get install libaio1，否则即使路径对了也会卡在依赖缺失 - PyCharm 控制台里 pip install 成功不代表运行时能用：IDE 启动的 Python 进程未必继承你 shell 里设置的环境变量，得在 PyCharm 的 Run Configuration → Environment variables 里显式加
LD_LIBRARY_PATH
