在使用 Python.NET 从 C# 调用 Python 脚本时，若未显式、成对地获取与释放全局解释器锁（GIL），程序退出或长时间空闲后易触发 GIL must be released 异常。本文详解安全调用模式及关键实践要点。
在使用 python.net 从 c# 调用 python 脚本时，若未显式、成对地获取与释放全局解释器锁（gil），程序退出或长时间空闲后易触发 `gil must be released` 异常。本文详解安全调用模式及关键实践要点。
Python.NET 基于 CPython 运行时，其线程模型严格依赖 全局解释器锁（GIL） 的手动管理。错误的核心在于：Py.GIL() 返回一个 GILState 对象，它必须被显式 Dispose()，且必须在同一线程中释放——而 using (var gil = Py.GIL()) { ... } 在某些版本（尤其是 3.0+）中可能因作用域提前退出或异常中断导致 Dispose() 未执行，最终由终结器（Finalizer）尝试释放，但此时线程上下文已变更，从而抛出 InvalidOperationException。
✅ 正确做法是：显式捕获 GILState，确保其在 try-finally 或明确位置被释放，而非依赖 using 的隐式处置（因其析构行为不可靠）。以下是经过验证的安全调用模板：
// 初始化（仅需一次，通常在应用启动时）
Runtime.PythonDLL = @"C:\Users\micro\AppData\Local\Programs\Python\Python39\python39.dll";
PythonEngine.Initialize();
PythonEngine.BeginAllowThreads(); // 允许其他线程调用 Python（可选，但推荐）
// 执行 Python 脚本调用
Py.GILState gil = null;
try
{
gil = Py.GIL(); // 显式获取 GIL
using (var scope = Py.CreateScope())
{
dynamic sys = Py.Import("sys");
sys.path.append(@"C:\Users\micro\source\repos\REFWebApp\REFWebApp.Server\Evaluation\STTs\");
var scriptCompiled = Py.Import(scriptname);
var result = scriptCompiled.InvokeMethod("transcribe_all", filenames.ToPython());
// 安全转换返回值
if (result != null)
{
PyObject[] pylist = result.AsManagedObject(typeof(PyObject[])) as PyObject[];
if (pylist != null)
{
var transcriptions = new List<string>();
foreach (PyObject item in pylist)
{
string transcript = item.As<python.runtime.pystring>().AsString();
Console.WriteLine(transcript);
transcriptions.Add(transcript);
}
return transcriptions;
}
}
}
}
finally
{
gil?.Dispose(); // 关键：确保释放，即使发生异常
}
return new List<string>();</string></python.runtime.pystring></string>
⚠️ 注意事项：
- Py.GIL() 必须与 gil.Dispose() 成对出现，且不能跨线程；避免在 using 中直接包装 Py.GIL()（旧版文档常见误区）。
- PythonEngine.BeginAllowThreads() 应在初始化阶段调用一次，以支持多线程并发调用 Python（否则后续线程调用会阻塞或失败）。
- Py.CreateScope() 本身不持有 GIL，所有 Python 对象操作（如 Py.Import、InvokeMethod）均需在 GIL 持有状态下执行。
- 不要手动调用 PythonEngine.Shutdown() —— 它会终止整个 Python 运行时，影响后续调用；应让 Python.NET 在应用退出时自动清理。
- 若脚本执行耗时较长，建议结合 CancellationToken 实现超时控制，并在取消时仍保证 gil.Dispose()。
总结：该异常本质是 GIL 生命周期管理失配。通过 try-finally 显式保障 GILState.Dispose()，配合合理的作用域与初始化配置，即可彻底规避此问题，实现稳定、可伸缩的 C#–Python 互操作。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
