Ubuntu环境下cx_Oracle报DPI-1047无法定位64位Oracle Client库如何解决

核心问题说明 #

报错核心是cx_Oracle无法找到对应64位Oracle客户端的libclntsh.so库文件，按照以下步骤逐一排查即可： #

步骤1：验证库文件真实存在且权限正确 #

• 首先执行命令确认文件是否存在：ls -l /app/oracle/product/10.2.0/server/lib/libclntsh.so
  • 若提示文件不存在：检查该路径下是否有libclntsh.so.xx.x格式的版本文件，手动创建软链即可：sudo ln -s /app/oracle/product/10.2.0/server/lib/libclntsh.so.xx.x /app/oracle/product/10.2.0/server/lib/libclntsh.so（将xx.x替换为你实际存在的版本号）
  • 若文件存在但权限不足：执行命令赋予读权限：sudo chmod +r /app/oracle/product/10.2.0/server/lib/*

步骤2：验证ldconfig配置生效 #

• 查看Oracle库路径是否写入ldconfig配置：cat /etc/ld.so.conf.d/oracle.conf，若文件不存在或内容不是/app/oracle/product/10.2.0/server/lib，执行命令写入：echo "/app/oracle/product/10.2.0/server/lib" | sudo tee /etc/ld.so.conf.d/oracle.conf
• 刷新ldconfig缓存：sudo ldconfig
• 验证缓存中是否能找到对应库：ldconfig -p | grep libclntsh.so，有输出即为配置生效

步骤3：验证LD_LIBRARY_PATH环境变量配置 #

很多场景下cx_Oracle会优先读取LD_LIBRARY_PATH路径下的库，先做临时配置验证：

• 执行命令临时注入环境变量：export LD_LIBRARY_PATH=/app/oracle/product/10.2.0/server/lib:$LD_LIBRARY_PATH
• 重新运行你的Python程序，若不再报错则将配置永久写入当前用户环境变量：echo 'export LD_LIBRARY_PATH=/app/oracle/product/10.2.0/server/lib:$LD_LIBRARY_PATH' >> ~/.bashrc && source ~/.bashrc

步骤4：验证架构匹配 #

• 检查Oracle库架构：file /app/oracle/product/10.2.0/server/lib/libclntsh.so，输出需包含x86-64才是64位版本
• 检查Python运行环境架构：python3 -c "import platform;print(platform.architecture()[0])"，输出需为64bit，两者架构必须一致

步骤5：安装依赖包 #

缺少libaio依赖也会触发该报错，执行命令安装：sudo apt update && sudo apt install -y libaio1 #

内容的提问来源于stack exchange，提问作者Tsirsuna