运行Milvus时为何出现“ImportError: sys.meta_path is None, Python is likely shutting down”错误

我写了一段简单代码：

from pymilvus import MilvusClient

client = MilvusClient("milvus.db")
print("hello")

执行后输出如下：

hello
Exception ignored in: <function ServerManager.__del__ at 0x7f1b80758ea0>
Traceback (most recent call last):
  File "/usr/local/lib/python3.12/dist-packages/milvus_lite/server_manager.py", line 58, in __del__
  File "/usr/local/lib/python3.12/dist-packages/milvus_lite/server_manager.py", line 53, in release_all
  File "/usr/local/lib/python3.12/dist-packages/milvus_lite/server.py", line 118, in stop
  File "/usr/lib/python3.12/pathlib.py", line 1164, in __init__
  File "/usr/lib/python3.12/pathlib.py", line 358, in __init__
ImportError: sys.meta_path is None, Python is likely shutting down
Exception ignored in: <function Server.__del__ at 0x7f1b80758cc0>
Traceback (most recent call last):
  File "/usr/local/lib/python3.12/dist-packages/milvus_lite/server.py", line 122, in __del__
  File "/usr/local/lib/python3.12/dist-packages/milvus_lite/server.py", line 118, in stop
  File "/usr/lib/python3.12/pathlib.py", line 1164, in __init__
  File "/usr/lib/python3.12/pathlib.py", line 358, in __init__
ImportError: sys.meta_path is None, Python is likely shutting down

请问这是什么原因？

这个错误的核心原因是Python解释器在 shutdown 阶段回收对象时，Milvus Lite的__del__方法还在尝试执行依赖Python运行时的操作。

具体逻辑：

• 代码执行完print("hello")后程序即将结束，Python开始清理全局对象
• Milvus Lite的ServerManager和Server的析构方法__del__在这个阶段被触发，尝试调用stop()方法停止服务
• 但此时Python已经启动关闭流程，sys.meta_path已被置为None，而pathlib.Path初始化需要依赖该运行时环境，因此抛出ImportError

解决办法 #

1. 显式关闭客户端：在代码末尾主动调用client.close()，提前释放资源，避免Python shutdown阶段触发析构操作：

from pymilvus import MilvusClient

client = MilvusClient("milvus.db")
print("hello")
client.close()  # 主动关闭

2. 使用上下文管理器（推荐）：利用Python的上下文管理器自动管理资源，代码块结束时自动关闭客户端：

from pymilvus import MilvusClient

with MilvusClient("milvus.db") as client:
    print("hello")

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