当前位置：首页 > news >正文

ComfyUI 更新后 ModuleNotFoundError: No module named ‘pkg_resources‘报错修复指南

news 2026/5/12 15:34:15

ComfyUI 更新后`ModuleNotFoundError: No module named 'pkg_resources'`报错修复指南

问题背景

在更新 ComfyUI（源代码部署版）并重新安装requirements.txt后，用户通常会执行python -m pip install -U pip setuptools wheel来升级基础工具。然而，这一操作将setuptools升级到了最新的82.0.0 版本，导致 ComfyUI 启动时出现以下相同的几处报错：

ModuleNotFoundError: No module named 'pkg_resources'

根本原因：setuptools 82.0.0 的重大变更

setuptools 82.0.0 版本正式移除了pkg_resources模块。

自 2024 年起，setuptools 社区已明确将pkg_resources标记为已弃用，并建议开发者迁移至importlib.resources和importlib.metadata等标准库模块。在 82.0.0 版本中，该模块被彻底移除，不再随 setuptools 安装。

关键依据

官方弃用声明：setuptools 官方文档明确指出pkg_resources已弃用，并提供了迁移指南。
版本变更：setuptools 82.0.0 的发布日志（Changelog）确认了该模块的移除。

v82.0.0
2026年2月8日
弃用和移除
pkg_resources已从 Setuptools 中移除。其大多数常见用途已被importlib.resources和importlib.metadata项目取代。依赖其进行命名空间包或其他行为的项目和环境应依赖于旧版本的。（#3085）pkg_resourcespkg_resourcessetuptools

https://setuptools.pypa.io/en/latest/history.html#pkg-resources

修复方案

由于 ComfyUI 及其许多自定义节点（Custom Nodes）仍依赖pkg_resources进行资源管理和包发现，直接降级setuptools是最快、最有效的解决方案。

操作步骤

检查当前版本（确认问题来源）：
```
python -m pip show setuptools
```
如果输出显示版本为82.0.0，则确认是此原因导致。
降级 setuptools：
将 setuptools 降级至77.0.3 或81.0.0 等兼容版本。
```
python -m pip install setuptools==77.0.3
```
验证修复：
执行以下命令，如果显示“导入成功”且无报错，则说明修复完成。
```
python -c "import pkg_resources; print('pkg_resources 导入成功')"
```

修复结果

执行降级操作后，ComfyUI 将能够正常启动，且pkg_resources模块可正常导入。虽然控制台可能会显示DeprecationWarning（弃用警告），但这并不影响程序运行，仅提示该 API 未来可能不再可用。

长期建议

固定版本：在项目的requirements.txt或依赖管理文件中，建议将setuptools的版本固定为<82，例如setuptools>=70,<82，以避免未来自动升级导致再次中断。
关注迁移：对于自定义节点的开发者，建议关注 setuptools 的官方迁移指南，逐步将代码中的pkg_resources替换为importlib相关模块，以确保长期兼容性。

迁移后的代码示例：

import subprocess import sys from importlib.metadata import distribution, PackageNotFoundError try: distribution('some_package') # 检查包是否存在 except PackageNotFoundError: # 如果包不存在，则安装 subprocess.check_call([sys.executable, '-m', 'pip', 'install', 'some_package'])