ComfyUI「clean library entry point is missing」修复方法
通过检查前端包漂移、工作流 JSON 兼容性及缺失的自定义节点，修复 ComfyUI clean library entry point is missing 错误。
如果你搜索了 "clean library entry point is missing" comfyui、"a clean library entry point is missing" comfyui 或 "clean library entry point" comfyui main.py，请不要一上来就随便安装某个 Python 包。
这条消息通常指向工作流或前端兼容性问题：工作流是由更新版本或不同配置的 ComfyUI 保存的、前端包已过时、工作流 JSON 不兼容，或者提供工作流某部分功能的自定义节点缺失。
快速解答
首先同时更新 ComfyUI 及其前端包，然后从 http://127.0.0.1:8188 重新打开工作流。如果仍有红色节点，将其视为缺失节点问题处理。不要运行 pip install clean-library-entry-point，那不是真正的包修复方案。
快速诊断
| 所见现象 | 可能原因 | 第一步 |
|---|---|---|
打开工作流时出现 clean library entry point is missing | 工作流期望某个库入口，但当前前端或工作流系统无法解析 | 同时更新 ComfyUI 和前端包 |
a clean library entry point is missing 加上旧前端警告 | 前端包漂移 | 参考 comfyui-frontend-package 指南 |
| 警告后出现红色节点 | 工作流还需要自定义节点 | 参考 ComfyUI 缺失节点 |
node id has no class_type | 工作流 JSON 可能损坏或由不兼容工具导出 | 如可能，从原始来源重新导出 |
Failed to Save Workflow Draft | 浏览器工作流状态保存失败 | 参考 工作流草稿保存失败 |
为什么这不是普通的缺失包错误
clean library entry point 这个短语不是包名。它是一个线索，说明 ComfyUI 或其前端无法将工作流/库状态的某部分映射到当前安装中可用的内容。
这意味着正确的处理顺序是：
- 检查你的 ComfyUI 代码和前端包是否同步。
- 确认工作流是从本地 URL 打开的，而不是先通过代理或远程页面。
- 检查工作流 JSON 是否由更新版本的 ComfyUI 创建。
- 然后再处理缺失的自定义节点或导入失败问题。
如果终端提示 ModuleNotFoundError: No module named ...，请切换到 No module named 指南。那是不同层面的故障。
第一步：在本地打开 ComfyUI
首先打开本地地址：
http://127.0.0.1:8188在工作流能在本地正常打开之前，避免通过局域网 IP、反向代理、远程隧道或嵌入式浏览器进行调试。如果本地 URL 正常但远程 URL 不行，这是浏览器或网络路径问题，不一定是工作流问题。
第二步：检查前端包漂移
如果同一安装还显示如下警告：
frontend version is outdated
comfyui-frontend-package is not installed
Failed to check frontend version请先修复这个问题。由较新 UI 创建的工作流，在后端与前端包不同步时可能会暴露兼容性问题。
参考 comfyui-frontend-package 指南，安装你本地 ComfyUI/requirements.txt 所需的包版本。不要盲目将最新前端包安装到系统 Python 中。
第三步：重新打开或重新导出工作流
如果工作流来自其他用户，请再次索取原始 .json 文件，或询问创建该工作流所用的 ComfyUI 版本。
如果是你自己创建的工作流且图表仍然打开：
- 立即使用另存为或导出工作流 JSON。
- 如果可能，保存一张带元数据的输出 PNG。
- 更新前端/核心包后重启 ComfyUI。
- 从本地 ComfyUI 页面重新打开 JSON。
如果消息变为 node id has no class_type，将该工作流 JSON 视为损坏或不兼容，并使用 ComfyUI 缺失节点 进行下一步处理。
第四步：检查缺失节点
入口点警告消失后，工作流可能仍会显示红色节点。
这并不意味着第一次修复失败，而是说明工作流现在可以被解析到足够深的程度，从而暴露出下一个问题。
按以下顺序处理：
- 查看红色节点的名称。
- 仅在 ComfyUI Manager 能加载其注册表时，才使用它的缺失节点安装功能。
- 如果 Manager 提示
failed to get custom node list，参考 ComfyRegistry 列表指南。 - 如果插件文件夹存在但节点仍为红色，检查
IMPORT FAILED并参考 插件导入失败。
不要做的事
- 不要搜索字面意思为
clean library entry point的包。 - 如果图表可见，不要在导出工作流 JSON 之前重新安装 ComfyUI。
- 在根本原因是前端或工作流兼容性问题时，不要运行每个自定义节点的
requirements.txt。 - 不要将
Failed to Save Workflow Draft、failed to fetch server logs和缺失节点视为同一种错误。
Wonderful Launcher 如何提供帮助
当修复涉及多个层面时，Wonderful Launcher 能提供帮助：前端漂移、工作流导入、缺失节点、插件导入失败以及缺失模型资产。它将活动的 ComfyUI 路径和启动日志保持在修复流程附近，让你不会修错安装目录。
如果你希望在重新安装之前有一个引导式的环境检查方式，请下载 Wonderful Launcher。
相关指南
- ComfyUI 缺失节点、class_type 及工作流导入修复
- comfyui-frontend-package 未安装或前端版本过时
- ComfyUI 工作流草稿保存失败
- ComfyUI 获取自定义节点列表失败
- ComfyUI 插件导入失败
来源参考
- ComfyUI 官方更新指南
- ComfyUI 前端管理源码
- ComfyUI 工作流概念
- Wonderful Launcher GSC 查询页面映射，2026 年 6 月 1 日至 29 日
先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。
下载 Wonderful Launcher查看 credits 方案这篇文件解決了你的問题嗎？
你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。
热门 ComfyUI 自定义节点包：Easy Use、Layer Style、rgthree 与 VideoHelperSuite
安全安装与排查热门 ComfyUI 自定义节点包：Easy Use、Layer Style、rgthree、VideoHelperSuite，以及节点缺失导致的导入失败问题。
ComfyUI ControlNetApplyAdvanced class_type 修复
通过分离工作流 JSON、ComfyUI 版本、ControlNet 模型和自定义预处理器，修复 ComfyUI ControlNetApplyAdvanced class_type、node id has no class_type 以及 Apply ControlNet Advanced 缺失错误。