如何将Python的DLL加载行为恢复至3.8版本之前的状态？

问题背景 #

Python官方文档对3.8版本的破坏性变更说明：

3.8版本新增：此前的CPython版本会使用当前进程的默认行为解析DLL，这导致了不一致性，例如仅在某些情况下搜索PATH或当前工作目录，且AddDllDirectory等系统函数无法生效。

此前一直沿用将DLL目录加入PATH的跨平台流程，可通过dlldiag等工具验证DLL路径，工作流成熟稳定。但3.8+版本强制使用os.add_dll_directory()管理DLL路径，带来诸多问题：

• 无法读取已添加的DLL目录，无便捷变量用于修改或验证
• 尝试将PATH中所有目录加入DLL搜索路径的代码：

  import os
  for p in os.environ['path'].split(';'):
      if os.path.isdir(p):
          os.add_dll_directory(p)
  

  解决了ImportError: DLL load failed while importing foo: The specified module could not be found（实际为缺失依赖DLL，但提示不明确），但又出现新错误：

  ImportError: DLL load failed while importing foo: The operating system cannot run %1
  该错误实际是路径中存在多个候选DLL（如发布版/调试版），导致加载冲突

• 跨进程执行脚本时，添加的DLL路径无法继承，需额外处理
• os.add_dll_directory()仅Windows可用，破坏跨平台兼容性，且win32api.LoadLibrary()与ctypes加载DLL的行为不一致

解决方案：恢复至Python 3.8之前的DLL加载行为 #

要回退到3.8之前的DLL搜索逻辑，可通过设置环境变量实现：

• 启动Python前设置环境变量：
  在命令行中执行：

  set PYTHONLEGACYWINDOWSDLLLOADING=1
  python your_script.py
  

  或者在Python脚本开头（需在导入任何依赖DLL的模块前）设置：

  import os
  os.environ['PYTHONLEGACYWINDOWSDLLLOADING'] = '1'
  

  该环境变量会让Python恢复使用Windows传统的DLL搜索顺序（优先当前工作目录，再搜索PATH）

• 替代方案：自定义跨平台DLL路径管理
  如果不想完全回退，可封装跨平台的DLL路径管理逻辑：

  import os
  import sys
  
  def add_dll_paths(paths):
      if sys.platform == 'win32':
          if hasattr(os, 'add_dll_directory'):
              for path in paths:
                  if os.path.isdir(path):
                      os.add_dll_directory(path)
      else:
          # 类Unix系统处理动态库路径
          lib_path_var = 'LD_LIBRARY_PATH' if sys.platform != 'darwin' else 'DYLD_LIBRARY_PATH'
          current = os.environ.get(lib_path_var, '')
          new_paths = ':'.join(paths) + (f':{current}' if current else '')
          os.environ[lib_path_var] = new_paths
  
  # 使用示例：添加PATH中的目录
  path_sep = ';' if sys.platform == 'win32' else ':'
  add_dll_paths(os.environ.get('PATH', '').split(path_sep))
  

  针对多进程场景，可通过传递环境变量同步DLL路径：

  import subprocess
  import os
  import sys
  
  env = os.environ.copy()
  # 将所需DLL目录加入PATH传递给子进程
  if sys.platform == 'win32':
      env['PATH'] = ';'.join(custom_dll_paths) + ';' + env['PATH']
  subprocess.run(['python', 'child_script.py'], env=env)
  

处理DLL版本冲突问题 #

针对发布版/调试版DLL共存的场景：

• 启动脚本时，根据当前运行环境（调试/发布）动态添加对应DLL目录，而非全部加入
• 使用dlldiag或dumpbin工具提前检查DLL依赖，确保路径中仅包含所需版本的DLL目录

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