Python 程序无法找到 Oracle 的 64 位客户端库 (libclntsh.so)

数据库错误: DPI-1047: Cannot locate a 64-bit Oracle Client library: "libclntsh.so: cannot open shared object file: No such file or directory". See https://oracle.github.io/odpi/doc/installation.html#linux for help

这个错误表明 Python 程序无法找到 Oracle 的 64 位客户端库 (libclntsh.so)。以下是完整的解决方案:


完整解决方案(Linux 环境)

1. 安装 Oracle Instant Client(推荐方式)

(1) 下载 Oracle Instant Client Basic 包

从 Oracle 官网下载 19c21c 版本的 Basic 包:

bash

复制代码
# 进入下载目录(如 /opt/oracle)
sudo mkdir -p /opt/oracle
cd /opt/oracle

# 下载 Basic 包(示例为 19.19 版本)
wget https://download.oracle.com/otn_software/linux/instantclient/199000/instantclient-basic-linux.x64-19.9.0.0.0dbru.zip

# 解压
sudo unzip instantclient-basic-linux.x64-19.9.0.0.0dbru.zip

如果 wget 报错,可手动从 Oracle 官网 下载并上传到服务器。

(2) 设置环境变量

bash

复制代码
# 临时生效(当前会话)
export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_9

# 永久生效(写入 ~/.bashrc 或 /etc/profile)
echo 'export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_9' >> ~/.bashrc
source ~/.bashrc
(3) 创建符号链接(关键步骤!)

bash

复制代码
sudo ln -s /opt/oracle/instantclient_19_9/libclntsh.so.19.1 /usr/lib/libclntsh.so

sudo yum install libnsl


2. 验证是否生效

bash

复制代码
# 检查库文件是否存在
ls -l /opt/oracle/instantclient_19_9/libclntsh.so*

# 检查环境变量
echo $LD_LIBRARY_PATH

# 测试 Python 是否能导入 cx_Oracle
python3 -c "import cx_Oracle; print('Success')"

如果没有报错,说明配置成功!


3. 在你的 Python 代码中强制指定 Oracle 客户端路径

如果仍然报错,可以在代码中显式指定 Oracle 客户端路径:

python

复制代码
import cx_Oracle

# 手动指定 Oracle 客户端路径
cx_Oracle.init_oracle_client(lib_dir="/opt/oracle/instantclient_19_9")

# 然后正常连接数据库
conn = cx_Oracle.connect("DB_MON/db_mon@rpt2.fastfish.com.cn:1521/orcl")

4. 其他可能的问题

(1) 32 位 vs 64 位不匹配
  • 确保 Python 和 Oracle Instant Client 都是 64 位

    bash

    复制代码
    # 检查 Python 位数
    python3 -c "import sys; print(sys.maxsize > 2**32)"
    • 输出 True 表示 64 位 Python。
  • 检查 Oracle Instant Client 位数:

    bash

    复制代码
    file /opt/oracle/instantclient_19_9/libclntsh.so
    • 应显示 ELF 64-bit
(2) 缺少 libaio 依赖

bash

复制代码
# CentOS/RHEL
sudo yum install libaio

# Ubuntu/Debian
sudo apt-get install libaio1
(3) 文件权限问题

确保当前用户有权访问 Oracle Instant Client:

bash

复制代码
sudo chmod -R +r /opt/oracle/instantclient_19_9

5. 最终代码示例

python

复制代码
import cx_Oracle
import os

# 设置 Oracle 客户端路径(可选)
os.environ["LD_LIBRARY_PATH"] = "/opt/oracle/instantclient_19_9"

# 显式初始化 Oracle 客户端
cx_Oracle.init_oracle_client(lib_dir="/opt/oracle/instantclient_19_9")

# 连接数据库
try:
    conn = cx_Oracle.connect("DB_MON/db_mon@rpt2.fastfish.com.cn:1521/orcl")
    print("连接成功!")
    conn.close()
except Exception as e:
    print("连接失败:", e)

总结

问题 解决方案
DPI-1047 错误 安装 Oracle Instant Client 并设置 LD_LIBRARY_PATH
libclntsh.so 找不到 检查路径并创建符号链接
32/64 位不匹配 确保 Python 和 Oracle 客户端都是 64 位
缺少 libaio 安装 libaioyum install libaioapt install libaio1
权限问题 确保 /opt/oracle 可读

如果仍然报错,请检查:

  1. 是否下载了正确版本的 Instant Client?

  2. LD_LIBRARY_PATH 是否生效?

  3. 是否执行了 source ~/.bashrc

希望这能彻底解决问题! 🚀

方法1:直接通过命令修改(临时生效)

bash

复制代码
export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_9
方法2:永久修改(编辑.bashrc文件)
  1. 打开.bashrc文件:

bash

复制代码
nano ~/.bashrc
  1. 找到设置LD_LIBRARY_PATH的行(可能是这样的):

bash

复制代码
export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_9:/opt/oracle/instantclient_19_9:
  1. 修改为(删除重复路径和结尾冒号):

bash

复制代码
export LD_LIBRARY_PATH=/opt/oracle/instantclient_19_9
  1. 保存退出nano:
  • Ctrl+O 保存

  • Enter 确认

  • Ctrl+X 退出

  1. 使修改生效:

bash

复制代码
source ~/.bashrc
相关推荐
余子越13 分钟前
Python StringIO 和 BytesIO 用法
后端·python
freed_Day18 分钟前
人工智能与机器学习基本概念知识入门
开发语言·人工智能·python·机器学习
余子越18 分钟前
Python 文件读写详解
后端·python
Waitind_43 分钟前
Python数据分析常规步骤整理
开发语言·python·数据分析
这里有鱼汤1 小时前
Python 虚拟环境是什么?它到底是怎么工作的?
后端·python
WSSWWWSSW2 小时前
大语言模型提示工程与应用:ChatGPT提示工程技术指南
人工智能·python·语言模型·chatgpt·大模型
IMER SIMPLE2 小时前
人工智能-python-机器学习-决策树与集成学习:决策树分类与随机森林
人工智能·python·机器学习
荔枝吻2 小时前
【保姆级喂饭教程】python基于mysql-connector-python的数据库操作通用封装类(连接池版)
数据库·python·mysql
jie*2 小时前
小杰python高级(one day)——线性代数
开发语言·python
速易达网络2 小时前
政府数字化大屏系统 - Flask实现方案
后端·python·flask