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.02026年2月8日弃用和移除pkg_resources已从 Setuptools 中移除。其大多数常见用途已被importlib.resources和importlib.metadata项目取代。依赖其进行命名空间包或其他行为的项目和环境应依赖于旧版本的。#3085pkg_resourcespkg_resourcessetuptoolshttps://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 setuptools77.0.3验证修复执行以下命令如果显示“导入成功”且无报错则说明修复完成。python -c import pkg_resources; print(pkg_resources 导入成功)修复结果执行降级操作后ComfyUI 将能够正常启动且pkg_resources模块可正常导入。虽然控制台可能会显示DeprecationWarning弃用警告但这并不影响程序运行仅提示该 API 未来可能不再可用。长期建议固定版本在项目的requirements.txt或依赖管理文件中建议将setuptools的版本固定为82例如setuptools70,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])参考链接setuptools 82.0.0 发布信息 - PyPIpkg_resources 弃用说明 - setuptools 官方文档