【避坑指南】部署 Open WebUI 报错：ModuleNotFoundError: No module named ‘pkg_resources‘ 彻底解决方法

目录

【避坑指南】部署 Open WebUI 报错：ModuleNotFoundError: No module named 'pkg_resources' 彻底解决方法

前言

问题描述

环境背景

原因分析

解决方案

第一步：补齐基础依赖

第二步：彻底解决（推荐）

第三步：验证修复

进阶：针对 Open WebUI 的额外提示

总结

---

【避坑指南】部署 Open WebUI 报错：ModuleNotFoundError: No module named 'pkg_resources' 彻底解决方法

前言

最近在本地环境（Windows + Conda）尝试部署 Open WebUI 并集成 Milvus 向量数据库时，遇到了一个典型的 Python 环境依赖问题。尽管已经安装了 pymilvus，但在项目启动时依然抛出了 Traceback 异常。今天把这个问题的成因和最快解法分享给大家。

---

问题描述

在启动 Open WebUI 后台（backend）时，程序在初始化向量数据库客户端阶段崩溃。核心报错信息如下：

Plaintext

File "...\site-packages\pymilvus\client\__init__.py", line 6, in <module> from pkg_resources import DistributionNotFound, get_distribution ModuleNotFoundError: No module named 'pkg_resources' 

环境背景

• 项目: Open WebUI
• 数据库: Milvus (Standalone) / PostgreSQL
• Python 环境: Conda (Python 3.10+)
• 依赖库: pymilvus

---