PyDLL跨Python版本无法工作问题求助

AI 小北

2026-7-6

问题：跨Python 3.x版本加载PyDLL失败的原因与解决方案

问题背景

我正在使用PyDLL将DLL绑定到Python，遇到了跨版本兼容性问题。

Python端代码

import ctypes as _ct
_path = _parent_path(__file__) / "scisuit_pybind"
pydll = _ct.PyDLL(str(_path))

pydll.c_root_bisect.argtypes = [_ct.py_object, _ct.c_double, _ct.c_double, _ct.c_double, _ct.c_int, _ct.c_char_p, _ct.c_bool]
pydll.c_root_bisect.restype = _ct.py_object

C++端代码

#define EXTERN \
    extern "C" DLLPYBIND

EXTERN PyObject * c_root_bisect(PyObject * FuncObj,
    double a,
    double b,
    double tol = 1e-5,
    int maxiter = 100,
    const char* method = "bf",
    bool modified = false);

测试情况

用Python 3.10.6编译的DLL，在Python 3.10.6中可正常运行，但在Python 3.11中加载失败
用Python 3.11编译的DLL，在Python 3.11中可正常运行，但在Python 3.10中加载失败

报错信息

self._handle = _dlopen(self._name, mode)

临时解决方案

我找到一个临时解决方案（可能不是最优）：为不同3.x版本分别编译DLL（当前已生成3.10和3.11版本），然后在Python端通过版本判断加载对应DLL：

_DLLname= "scisuit_pybind"
if sys.version_info.minor == 10:
    _DLLname= "scisuit_pybind310"

_path = _parent_path(__file__) / _DLLname

原因分析

你忽略的核心是Python 3.x小版本间的C API二进制不兼容性：

Python 3的不同小版本（如3.10和3.11）的C API存在底层二进制变化，编译DLL时会链接对应版本的Python运行时库（例如python310.dll或python311.dll）
用Python 3.10编译的DLL依赖python310.dll，在Python 3.11环境中加载时，系统无法找到匹配的运行时库，或找到的版本不兼容，导致_dlopen加载失败；反之亦然。