Python2.7转3.11调用Fortran DLL遇libgfortran初始化失败问题

问题背景 #

将Python2.7下基于Fortran DLL的本地包装包迁移至Python3.11时，加载libSEMFEM.dll触发错误：OSError: [WinError 1114] 动态链接库(DLL)初始化例程失败。简化复现代码如下：

from ctypes.util import find_library
from ctypes import CDLL

library_path = find_library("libSEMFEM")
clib = CDLL(library_path,0x102)

排查关键点 #

• Python2.7加载DLL时使用的mode为0x102，而Python3.11默认winmode=None对应0x1100（LOAD_LIBRARY_SEARCH_DEFAULT_DIRS | LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR），加载模式差异导致依赖库搜索逻辑变化
• Windows事件日志显示错误根源为libgfortran_64-3.dll，异常代码0xc0000005（访问违规）
• Dependency Walker确认libSEMFEM.dll依赖libgfortran_64-3.dll
• 尝试winmode=0x102可加载主DLL，但触发AttributeError: function 'FUNCTION_NAME' not found；winmode=0x1仅能加载基础DLL，依赖库加载失败

解决方案 #

1. 确保依赖库版本匹配且路径正确 #

• 确认libgfortran_64-3.dll的版本与编译libSEMFEM.dll时使用的GFortran版本完全一致（不同版本的gfortran DLL不兼容）
• 将libgfortran_64-3.dll所在目录加入系统PATH，或直接放置到libSEMFEM.dll的同目录下，消除搜索路径歧义

2. 显式加载依赖库并调整winmode参数 #

先加载依赖的libgfortran_64-3.dll，再加载主DLL，使用Python2.7兼容的0x102模式（LOAD_WITH_ALTERED_SEARCH_PATH）：

from ctypes import CDLL
import os

# 获取主DLL路径
library_path = find_library("libSEMFEM")
# 加载依赖库（假设和主DLL同目录）
gfortran_dll = os.path.join(os.path.dirname(library_path), "libgfortran_64-3.dll")
CDLL(gfortran_dll, winmode=0x102)

# 加载主DLL
clib = CDLL(library_path, winmode=0x102)

3. 处理Fortran函数名修饰问题 #

Fortran编译的DLL会对函数名进行名字修饰（如添加下划线后缀FUNCTION_NAME_），这是导致函数找不到的核心原因：

• 用dumpbin /exports libSEMFEM.dll命令或Dependency Walker查看DLL导出的实际函数名
• 使用修饰后的名字访问函数：

  # 示例：若实际导出名为FUNCTION_NAME_
  target_func = clib.FUNCTION_NAME_
  

• 或编译Fortran代码时添加-fno-underscoring选项，禁用名字修饰，保持函数名原样

4. 验证Python与DLL的位数匹配 #

确保使用64位Python3.11版本，因为libgfortran_64-3.dll是64位库，32位Python无法加载64位DLL

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