在 C++ 中嵌入 Python 时，反复调用 Py_Initialize / Py_FinalizeEx 会导致 PyO3 模块（如 pydantic_core）残留状态，引发「PyO3 modules may only be initialized once」错误；根本解法是进程内仅初始化和终结 Python 一次。

在 c++ 中嵌入 python 时，反复调用 `py_initialize` / `py_finalizeex` 会导致 pyo3 模块（如 `pydantic_core`）残留状态，引发「pyo3 modules may only be initialized once」错误；根本解法是**进程内仅初始化和终结 python 一次**。

在基于 CPython C API 的嵌入式场景中（例如使用 Py_Initialize() 启动解释器、执行 .py 脚本后调用 Py_FinalizeEx() 清理），看似规范的生命周期管理，在导入 openai 及其依赖链（pydantic → pydantic_core）时会暴露严重缺陷。错误日志中的关键线索：

<code class="text">ImportError: PyO3 modules compiled for CPython 3.8 or older may only be initialized once per interpreter process</code>

表明底层 Rust 扩展（通过 PyO3 构建）不支持解释器的多次启停——即使 Py_FinalizeEx() 成功返回，部分全局状态（如静态模块注册表、类型缓存、GIL 相关句柄）仍可能未被彻底清除，导致二次 Py_Initialize() 触发重复加载冲突。

✅ 正确实践：单进程单解释器生命周期

python-pro

高级 Python 特性、异步编程、性能调优、静态类型、内存管理、Python 内部机制及生态库方面的专家。

下载

• 在程序启动时（如 main() 开始）调用 Py_Initialize() 或 Py_InitializeEx(0)；
• 全程复用同一 Python 解释器实例执行所有脚本（可通过 PyRun_String, PyObject_CallObject 等安全调用）；
• 禁止在运行期间反复调用 Py_FinalizeEx()；
• 仅在程序退出前（如 main() 结束前）调用一次 Py_FinalizeEx()（推荐）或 Py_Finalize()（兼容旧版）。

⚠️ 补充注意事项：

• 若需隔离不同脚本的运行环境（如防止全局变量污染），应使用 PyModule_NewObject() 创建独立命名空间、或通过 importlib.util.spec_from_file_location() + importlib.util.module_from_spec() 动态导入并显式管理模块生命周期，而非重启解释器；
• openai SDK v1+ 强依赖 pydantic>=2.0 和 pydantic_core，二者均为 PyO3 编译模块，属于“不可重入”组件，此限制具有普遍性，不仅限于 openai；
• 对于必须热重载脚本的高级需求，建议改用子进程模型（如 fork + exec 或跨进程 RPC），将 Python 执行完全隔离，从根本上规避解释器状态残留问题。

总结：Py_FinalizeEx() 并非“完全清理”，而是设计为进程终态清理函数。将其误用为“脚本级 reset”是常见误区。尊重 CPython 嵌入式 API 的设计契约——一次初始化，全程复用，终局终结——是稳定集成现代 Python 包（尤其是含 PyO3 扩展者）的前提。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！