使用PythonNet从C#调用Python脚本时出现GIL未释放错误

错误根源 #

报错的核心原因是GILState对象未被正确释放，或释放线程与获取线程不一致。当你直接调用Py.GIL()却不保存返回的GILState实例时，该实例会被GC回收，其Finalize方法会在GC线程尝试释放GIL，这就违反了“必须由获取GIL的线程释放”的规则，从而触发错误。

正确实现方案 #

1. 全局初始化Python引擎（仅执行一次）

Python引擎初始化应该在应用启动时全局执行一次，而非每次类实例化都重复操作：

// 应用启动阶段执行，整个生命周期仅一次
Runtime.PythonDLL = @"C:\Users\micro\AppData\Local\Programs\Python\Python39\python39.dll";
PythonEngine.Initialize();
// 此处不要直接获取GIL，留到实际调用Python代码时再处理

2. 严格在调用Python代码的线程中管理GIL

每次调用Python函数时，必须在当前线程通过using块获取并自动释放GIL，确保GIL的获取与释放都在同一个线程：

public class PythonScriptCaller
{
    public ICollection<object> ExecutePythonFunction()
    {
        // 用using块自动管理GILState的生命周期，确保当前线程释放GIL
        using (var gil = Py.GIL())
        {
            // 导入Python模块并调用函数
            dynamic pyModule = Py.Import("your_python_script");
            dynamic pyResultList = pyModule.target_function();
            
            // 将Python列表转换为C#集合
            var csharpCollection = pyResultList.AsManagedList<object>();
            return csharpCollection;
        }
    }

    // 应用退出时调用，关闭Python引擎
    public void Cleanup()
    {
        PythonEngine.Shutdown();
    }
}

3. 关键注意事项

• 禁止跨线程持有GIL：如果业务涉及多线程，每个调用Python代码的线程都必须单独获取/释放GIL，不能在A线程获取后到B线程使用或释放。
• 避免长时间持有GIL：GIL是Python全局解释器锁，长时间持有会阻塞其他Python线程执行，尽量在using块内只执行必要的Python交互逻辑。
• 不要在析构函数中释放资源：类的析构函数在GC线程执行，此时调用GIL释放或引擎关闭会导致线程不匹配问题，引擎关闭应放在应用退出的统一清理逻辑中。

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