如何解决 No module named 'cx_Oracle'

错误 No module named 'cx_Oracle' 通常是因为在你的 Python 环境中没有安装 cx_Oracle 模块。以下是解决问题的方法：

1. 确认环境

• 确保你在正确的 Python 环境下运行代码。如果使用虚拟环境，请激活它：

  source venv/bin/activate   # Linux/macOS
  venv\Scripts\activate      # Windows
  

2. 安装 cx_Oracle 模块

使用 pip 安装 cx_Oracle：

pip install cx_Oracle

如果你在安装时遇到问题，可能是因为缺少依赖。

3. 安装 Oracle Instant Client

• cx_Oracle 需要 Oracle Instant Client 支持。
• 下载 Oracle Instant Client。
• 解压并配置环境变量：
  • 将 LD_LIBRARY_PATH (Linux/macOS) 或 PATH (Windows) 指向 Instant Client 的目录。

4. 检查 cx_Oracle 的兼容性

• cx_Oracle 的版本可能与 Python 或 Oracle 客户端版本不兼容。
• 参考 cx_Oracle 文档 确认版本要求。

5. 测试安装

运行以下测试代码：

import cx_Oracle
print(cx_Oracle.version)

6. 常见问题及解决

• 问题 1：pip 找不到 cx_Oracle 模块。
  • 尝试升级 pip：

    pip install --upgrade pip
    

• 问题 2：安装 cx_Oracle 时出现错误。
  • 确保已安装 C/C++ 编译工具，例如 build-essential (Linux) 或 Visual Studio C++ Build Tools (Windows)。
• 问题 3：运行时报 DPI-1047: Cannot locate a 64-bit Oracle Client library。
  • 配置 Instant Client 的路径，或确保客户端版本与 Python 匹配。