使用SWIG生成的C++封装Python模块导入时触发GIL相关致命错误求助

我之前也碰到过一模一样的问题，这个错误的核心是C++代码执行时没有持有Python的全局解释器锁（GIL），而Python 3.10+对GIL的检查机制变得更严格了。结合你的环境和代码，给你几个可行的解决方案：

1. 在SWIG接口中添加GIL保护指令 #

这是最直接的修复方式，让SWIG自动为生成的封装代码添加GIL持有逻辑。修改你的example.i文件，在包含头文件前加上%gil;指令，确保所有C++方法执行时都会先获取GIL：

%module example
%{
#include "example.h"
%}

// 启用GIL自动管理，确保C++代码执行时持有GIL
%gil;
%include "example.h"

如果你只想针对特定方法做保护（比如构造函数），也可以单独为目标方法添加GIL处理逻辑：

%module example
%{
#include "example.h"
%}

// 为构造函数添加GIL保护
%exception try_class::try_class {
    PyGILState_STATE gstate = PyGILState_Ensure();
    $action
    PyGILState_Release(gstate);
}

// 为类方法添加GIL保护
%exception try_class::class_func {
    PyGILState_STATE gstate = PyGILState_Ensure();
    $action
    PyGILState_Release(gstate);
}

%include "example.h"

2. 检查CMake编译配置的正确性 #

确保你的CMakeLists.txt正确链接了Python的开发库，并且编译平台与Python位数完全匹配（你的Python是64位，所以必须编译x64版本的pyd文件）。以下是一个标准的CMake配置示例：

cmake_minimum_required(VERSION 3.22)
project(example)

find_package(SWIG REQUIRED)
include(${SWIG_USE_FILE})

# 指定Python 3.10版本，确保找到正确的开发组件
find_package(Python 3.10 REQUIRED COMPONENTS Development)

include_directories(${Python_INCLUDE_DIRS})
include_directories(${CMAKE_CURRENT_SOURCE_DIR})

set(CMAKE_CXX_STANDARD 17)
# 明确指定生成Python 3的封装代码
set(CMAKE_SWIG_FLAGS "-py3")

# 生成共享库类型的Python模块
SWIG_ADD_LIBRARY(example
    TYPE SHARED
    LANGUAGE Python
    SOURCES example.i example.cpp)

# 链接Python库
SWIG_LINK_LIBRARIES(example ${Python_LIBRARIES})

编译时一定要在Visual Studio中选择x64平台，避免32位/64位不匹配导致的奇怪错误。

3. 升级SWIG版本到最新稳定版 #

SWIG 4.0.2对Python 3.10的GIL处理可能存在兼容性bug，建议你升级到SWIG 4.1.x或更高版本（比如4.2.0），新版本修复了不少Python 3.10+的适配问题，能更稳妥地处理GIL相关逻辑。

4. 验证模块文件的完整性与路径 #

确保example.py和_example.pyd文件都在Python解释器的搜索路径中，没有损坏。可以在导入前先打印当前路径，确认模块所在目录在sys.path中：

import sys
print(sys.path)
import example

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