Py_FinalizeEx无法彻底清理环境，导入openai后重复运行脚本报错如何解决？

问题本质 #

你遇到的错误是因为PyO3（pydantic_core依赖的底层库）的旧版本（适配CPython 3.8及更早）不支持在同一个进程中多次初始化和终结Python解释器——PyO3的内部C级状态无法被Py_FinalizeEx()完全清理，第二次初始化时就会触发重复初始化错误。

可行解决方案 #

1. 复用Python解释器（推荐） #

放弃每次运行脚本都启停解释器的逻辑，改为仅在程序启动时初始化一次解释器，程序退出时再终结：

• 在C++程序的初始化阶段调用一次Py_Initialize()。
• 后续每次运行Python脚本时，直接使用已初始化的解释器执行（比如调用PyRun_File()或PyRun_SimpleString()）。
• 程序退出前调用Py_FinalizeEx()。
  这种方式从根源上避免了PyO3的重复初始化问题，是最稳定可靠的方案。

2. 升级依赖版本 #

如果必须多次启停解释器，可升级相关依赖到支持该场景的版本：

• 确保你的Python环境是3.9或更高版本（PyO3从适配3.9的版本开始修复了单进程多次初始化的问题）。
• 执行命令升级依赖：

  pip install --upgrade pydantic pydantic-core openai
  

升级后，PyO3的内部状态会在Py_FinalizeEx()时被正确清理，允许重复初始化。

3. 子进程隔离执行 #

若以上方案无法实施，可将Python脚本的执行放到独立子进程中：

• 每次需要运行脚本时，C++程序启动一个新的子进程，在子进程内单独完成Py_Initialize()、脚本执行、Py_FinalizeEx()的流程。
• 子进程结束后，系统会自动回收所有Python相关资源，不会影响主进程或后续子进程。
  该方案的缺点是进程创建销毁有性能开销，但能彻底隔离环境，避免状态残留。

4. 手动清理模块（不推荐） #

PyO3没有官方的状态清理接口，手动清理仅作最后尝试，无法保证效果：

• 在Python脚本末尾添加模块清理代码，尝试移除相关模块的引用：

  import sys
  for mod in list(sys.modules.keys()):
      if 'pydantic' in mod or 'openai' in mod:
          del sys.modules[mod]
  

但这种方法无法清理PyO3的C级内部状态，大概率无法解决问题，不建议使用。

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