如何配置Python环境通过cx_Oracle连接数据库？-Oracle-PHP中文网

不能只 pip install cx_Oracle 就完事——缺 Instant Client 会直接报 DPI-1047 或 ORA-24550；必须手动下载匹配版本的 Basic 包（非 Basic Light），解压至无空格无中文路径，Windows 加 bin 目录到 PATH、Linux/macOS 加 lib 目录到 LD_LIBRARY_PATH，并重启终端验证 import cx_Oracle 成功。

如何配置python环境通过cx_oracle连接数据库？

不能只 pip install cx_Oracle 就完事——缺 Instant Client 会直接报 DPI-1047 或 ORA-24550

Instant Client 下载和 PATH 配置是硬门槛

cx_Oracle 是基于 Oracle 客户端 C 库（OCI）的封装，它不自带 oci.dll（Windows）或 libclntsh.so（Linux），必须手动下载 Instant Client 并让系统能“看见”它。

只下 Basic 包（不是 Basic Light），64 位 Python 就必须配 64 位 Instant Client，版本建议选 19.21 或 21.10（长期支持、兼容性稳）
解压路径必须无空格、无中文，例如 C:\oracle\instantclient_21_10；Linux/macOS 要把该路径加进 LD_LIBRARY_PATH（不是 PATH）
Windows 下把 C:\oracle\instantclient_21_10\bin 加进系统级 PATH，改完后**必须重启所有终端和 IDE**，否则 Python 进程加载不到 DLL
验证方式：新开命令行，运行 python -c "import cx_Oracle; print(cx_Oracle.version)"；成功输出版本号才算过这一关

连接字符串写法和 service_name / SID 区别

Oracle 的连接标识容易混淆：service_name 和 SID 不是同一个东西，用错会导致 ORA-12514: TNS:listener does not currently know of service requested。

librosa Python 音频与音乐分析库

librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。

下载

现代 Oracle 数据库（12c+）默认启用 service_name，它由数据库自动注册，格式通常是 ORCLCDB.localdomain 或 XE
SID 是实例名，老版本常用，现在多数场景已不推荐；如果 DBA 给你的是 tnsnames.ora 片段，注意看 (SERVICE_NAME = ...) 还是 (SID = ...)

连接字符串三种等效写法：

cx_Oracle.connect("user/pass@host:1521/ORCLCDB")

cx_Oracle.connect(user="user", password="pass", dsn="host:1521/ORCLCDB")

tns = cx_Oracle.makedsn("host", 1521, service_name="ORCLCDB"); cx_Oracle.connect("user", "pass", tns)

中文乱码和 ORA-24550 崩溃问题

不处理编码和连接生命周期，程序可能跑着跑着就崩，或者查出来一堆问号。

中文显示/插入失败？在 import cx_Oracle 前加这句：os.environ["NLS_LANG"] = "SIMPLIFIED CHINESE_CHINA.AL32UTF8"（注意不是 UTF-8，是 AL32UTF8）
进程退出时报 ORA-24550: signal received: Exception code=0xc0000005？说明连接对象没释放；务必用 conn.close()，更稳妥的是用上下文管理器：
```
with cx_Oracle.connect(...) as conn:
    # do work
# conn 自动 close
```
如果用 SQLAlchemy，URL 中要显式指定 encoding：oracle+cx_oracle://user:pass@host:1521/XE?encoding=UTF-8&coerce_to_unicode=True

最常被跳过的其实是环境变量重载和 NLS_LANG 设置——这两个点不卡在开发机上，但一上测试服务器就集体失效。别信“本地能跑就行”，PATH 和环境变量得在目标环境里逐条验证。