cx_Oracle在打包生成的可执行文件中报DPI-1072仅IDE内正常

问题核心根因 #

结合你的调试日志，该报错的本质是exe运行时优先加载了非19.9版本的Oracle客户端DLL，和IDE环境下的加载行为出现明显差异：

• cx_Oracle 8.1本身完全支持19.9版本的Oracle Instant Client，不存在原生的版本兼容冲突
• auto-py-to-exe基于PyInstaller打包时，会自动扫描项目关联的依赖DLL，将扫描到的相关文件全部打包到exe运行时的临时解压目录（路径一般为C:\Users\<用户名>\AppData\Local\Temp\_MEIxxxxxx\）
• Windows系统加载DLL的优先级规则中，exe自身的临时解压目录优先级远高于代码中通过init_oracle_client(lib_dir=xxx)指定的路径，因此即使代码传了正确的19.9客户端路径，程序第一步加载到的依然是打包时混入的旧版本oci.dll，触发版本校验失败的DPI-1072报错
• 你看到的二次加载报错是因为第一次版本校验失败后，错误的DLL被系统卸载，此时临时目录的DLL已经失效，再按照原搜索规则定位库文件就会出现模块找不到的问题

具体操作步骤 #

• 打开auto-py-to-exe的配置面板，找到「排除模块/文件（Exclude All Files）」配置项，添加oci.dll、oraocci19.dll、oraociicus19.dll所有和Oracle客户端相关的文件名，禁止打包工具自动抓取这些DLL进exe包
• 在调用cx_Oracle.init_oracle_client之前，强制提升指定19.9客户端路径的DLL搜索优先级，代码调整为：

  import os
  import cx_Oracle
  
  oracle_client_path = r"你本地19.9版本Oracle Instant Client的实际绝对路径"
  # 把指定路径插到系统DLL搜索序列的最顶端
  os.add_dll_directory(oracle_client_path)
  os.environ["PATH"] = oracle_client_path + ";" + os.environ["PATH"]
  # 执行客户端初始化
  cx_Oracle.init_oracle_client(lib_dir=oracle_client_path)
  

• 打包时不要把Oracle客户端的DLL塞进exe包内部，改为通过「额外文件（Additional Files）」配置，把19.9版本的Instant Client整个文件夹作为外部文件，和exe放在同一目录层级，从根源上避免临时目录的旧DLL抢占加载优先级
• 打包完成后，先手动清理系统Temp目录下所有以_MEI开头的残留临时文件夹，再运行exe验证加载逻辑

结果验证 #

如果调整后依然出现DPI-1072报错，可以在初始化代码前加一行逻辑，打印当前进程实际加载的oci.dll路径，确认加载的文件来源：

import ctypes
# 加载指定路径的oci.dll后打印实际路径
loaded_dll = ctypes.CDLL(os.path.join(oracle_client_path, "oci.dll"))
print(f"当前加载的oci.dll地址: {loaded_dll._path}")

如果路径指向临时目录、系统System32目录，就说明之前的排除规则没有生效，需要重新核对打包配置。

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