Python3连接Oracle 11g报错：找不到cx_Oracle模块，求解决

错误原因 #

ModuleNotFoundError: No module named 'cx_Oracle' 说明当前Python环境未安装cx_Oracle模块，这是连接Oracle数据库的必要依赖。

解决方案 #

1. 安装兼容版本的cx_Oracle
   由于你使用的是Oracle 11g，需选择兼容的cx_Oracle版本（推荐8.3.0，更高版本不再支持Oracle 11g）。打开终端执行以下命令：

   pip install cx-Oracle==8.3.0
   

   注意：安装命令里用连字符cx-Oracle，代码中导入时用下划线cx_Oracle，两者写法不同。

2. 配置Oracle客户端

   • 下载适配Oracle 11g的Oracle Instant Client（Basic或Basic Light版本），解压到本地目录。
   • 将Instant Client的解压路径添加到系统PATH环境变量中：
     • Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量的PATH中添加对应路径。
     • Linux/macOS：在终端执行export PATH=/path/to/instantclient:$PATH，或写入~/.bashrc/~/.zshrc永久生效。

3. 验证安装
   重新运行你的连接代码，若能正常打印Oracle版本号，说明配置成功。

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