ComfyUI 无法获取自定义节点列表或 ComfyRegistry 列表修复
修复 ComfyUI Manager 无法获取自定义节点列表、无法找到 ComfyRegistry 列表、缓存过期、代理/防火墙拦截以及注册表网络故障等问题。
30 秒分诊决策
如果你目前可以直接在浏览器中正常使用 ComfyUI 的其他功能，这只是 Manager 的网络/缓存问题，不要重装软件。
- 如果需要下载节点却卡住：请优先检查你是否开启了 VPN/代理，或清空缓存。
- 如果界面直接打不开：说明是系统层面的网络或服务崩溃，请排查代理软件的端口设置。
如果你搜索了 ComfyUI failed to get custom node list、ComfyUI Manager failed to get custom node list、failed to find the following ComfyRegistry list、cannot connect to ComfyRegistry、failed to fetch versions from ComfyRegistry 或 the cache may be outdated, or the nodes may have been removed from ComfyRegistry，说明 ComfyUI Manager 无法加载或信任它用于搜索、安装、更新或匹配自定义节点的注册表数据。
如果浏览器只显示 Failed to fetch，先用 ComfyUI "Failed to Fetch" 判断失败请求是否真的属于 Manager，而不是 server logs、WebSocket 或 workflow draft。
这通常是 Manager 拉取、缓存或网络问题，并不意味着你整个 ComfyUI 安装已损坏。
如果浏览器 UI 卡在 Reconnecting... 或页面显示 failed to fetch server logs，请使用专用的浏览器连接指南，而不是将其当作自定义节点列表问题处理。
快速解答
如果你搜索了 "ComfyUI Manager failed to get custom node list" 或 "failed to find the following ComfyRegistry list"，请从这里开始：
- 检查正常的 ComfyUI 工作流是否仍能运行。
- 在同一台机器上打开 Manager GitHub 页面、ComfyRegistry 以及原始的
custom-node-list.jsonURL。 - 不要根据注册表错误信息中出现的词语去安装 Python 包。
- 如果消息提到 ComfyRegistry、failed to fetch versions 或缓存过期，请在修改插件之前先测试注册表/原始 GitHub 的访问情况。
- 如果 GitHub 和注册表访问正常但 Manager 仍然失败，则仅清除 Manager 缓存后重试。
不要先重装 Manager。要将注册表拉取失败与插件导入错误、红色节点以及 ComfyUI 完整启动失败区分开来。
如果启动日志中已经出现 IMPORT FAILED 或 ModuleNotFoundError，请先修复这些错误，而不是重装 Manager。如果问题发生在插件操作之后且 UI 也不稳定，请查阅 如何修复 ComfyUI 插件导入失败错误 和 ComfyUI 重连错误。
如果浏览器中显示的确切信息是 "failed to fetch server logs"，请改用 ComfyUI Failed to Fetch Server Logs。如果 UI 卡在 Reconnecting...，请使用 ComfyUI 重连错误。
精确错误日志
如果你的 ComfyUI 终端或启动日志中出现以下任何错误信息，本指南适合你：
failed to get custom node list
cannot connect to comfyregistry
failed to fetch versions from comfyregistry
error connecting to the comfy node registry.
[error] [comfyui-manager] an invalid channel was used: https://raw.githubusercontent.com/ltdrdata/comfyui-manager/main
failed to find the following comfyregistry list. the cache may be outdated, or the nodes may have been removed from comfyregistry.如果确切的消息是 failed to find the following ComfyRegistry list. the cache may be outdated, or the nodes may have been removed from ComfyRegistry，请在修改 Python 包之前先检查网络和缓存。该措辞通常属于 Manager 的注册表查找步骤，而非 pip、Torch 或缺失模型的问题。
如果提示"ComfyRegistry 列表"或"缓存可能已过期"
这种措辞通常意味着 Manager 试图通过注册表数据映射缺失的节点或包，但注册表请求、缓存列表或命名包查找失败了。
请按以下顺序处理：
- 不要根据错误文本安装随机包。 缺失的字符串可能是注册表包 ID，而不是 Python 包。
- 如果同一消息出现在许多工作流或包中，请先检查网络访问。
- 仅在访问正常后才清除 Manager 缓存，如果错误提到缓存过期或节点已被移除。
- 如果只有一个工作流或一个注册表包失败，请手动搜索确切的缺失节点或包名称。
- 如果文件夹存在但节点重启后仍未注册，请检查插件导入日志。
如果错误中包含包名，例如 comfy-core、whatdreamscost-comfyui 或其他注册表条目，请将该名称视为 Manager 查找步骤的线索。这并不自动意味着 pip、Torch 或整个 ComfyUI 安装已损坏。
如果此问题阻断了缺失节点修复
当此错误出现在安装缺失自定义节点过程中时，请在重试前先区分以下三种状态：
| 状态 | 实际情况 | 处理方式 |
|---|---|---|
| Manager 无法拉取其列表 | 注册表列表或原始 GitHub 数据无法加载 | 先修复 Manager 注册表/网络/缓存 |
| Manager 找到节点包但克隆失败 | 映射可能正确，但仓库下载失败 | 修复 Git、PATH、代理、GitHub 或仓库访问 |
| 插件已安装但节点仍为红色 | 文件夹存在，但插件重启后未注册 | 检查 IMPORT FAILED 并修复插件依赖 |
不要将这三种情况都视为"重装 Manager"。注册表失败、Git 克隆失败和插件导入失败需要不同的修复方式。
快速诊断
| 你看到的现象 | 最可能的原因 | 首先检查 |
|---|---|---|
| 错误仅在打开 Manager 或安装缺失节点时出现 | Manager 无法拉取其注册表 | 测试 GitHub 和原始 GitHub 访问 |
[warning] cannot connect to ComfyRegistry | 注册表 API、原始 GitHub、代理、DNS 或防火墙拦截了列表 | 在修改文件前先测试浏览器访问和其他网络 |
failed to fetch versions from ComfyRegistry | Manager 到达该功能但无法加载版本元数据 | 检查网络/代理，稍后重试，再考虑重装节点 |
the cache may be outdated, or the nodes may have been removed from ComfyRegistry | 缓存的注册表数据可能与当前注册表不匹配，或节点已被下架 | 确认网络访问正常后，备份并仅清除 Manager 缓存 |
| 现有工作流仍能运行 | 列表拉取问题，而非完整环境故障 | 暂不重装 |
| 红色节点加上自定义节点列表失败 | 缺失节点无法通过 Manager 映射 | 检查节点是否已注册 |
启动日志中出现 IMPORT FAILED | 已安装的自定义节点或依赖破坏了导入 | 先修复导入错误 |
| 在另一个网络上正常 | 代理、防火墙、DNS 或区域封锁 | 测试热点、VPN 或代理设置 |
| 重试后仍持续失败，但 ComfyUI 可以启动 | Manager 缓存过期或损坏 | 谨慎清除 Manager 缓存 |
错误的实际含义
ComfyUI Manager 依赖于注册表列表。官方 ComfyUI 文档将 Manager 描述为用于搜索、安装、更新和管理自定义节点（包括从导入工作流中缺失的节点）的工具。
对于节点作者，官方发布文档也将 custom-node-list.json 作为节点必须出现其中的注册表，以便 Manager 能够发现它。如果 Manager 无法拉取或读取这些数据，它可能无法知道哪个自定义节点包与你工作流中缺失的节点对应。
这就是为什么当你点击以下选项时，该消息经常出现：
- 安装缺失自定义节点
- Manager
- 搜索节点
- 更新节点
这并不总是意味着 ComfyUI 本身已损坏。
第一步：检查 ComfyUI 是否仍能运行
首先回答以下问题：
- 默认工作流是否仍能加载？
- 能否排队一个简单的图像任务？
- 已安装的自定义节点是否仍然显示？
- 唯一损坏的功能是 Manager 的自定义节点列表吗？
如果 ComfyUI 仍能运行，只有 Manager 无法拉取列表，则将其视为 Manager、网络或缓存问题。
如果 ComfyUI 在启动时失败、冻结、重连或显示导入错误，请从 ComfyUI 启动失败 或 如何修复 ComfyUI 插件导入失败错误 开始处理。
第二步：检查 GitHub 和注册表访问
Manager 通常需要访问托管在 GitHub 上的资源和注册表数据。在同一台机器上测试：
https://github.com/Comfy-Org/ComfyUI-Manager然后测试原始列表路径：
https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/custom-node-list.json如果 GitHub 页面可以打开但原始 URL 失败，说明你的网络、DNS、代理、防病毒软件或公司防火墙可能正在拦截原始 GitHub 资源。
尝试：
- 换一个浏览器
- 换一个网络或移动热点
- 临时禁用严格的网页过滤
- 检查 VPN 或代理设置
- 如果 GitHub 被限速或不稳定，稍后重试
第三步：读取 Manager 日志行
查看错误出现时 ComfyUI 终端输出。有用的线索包括：
FETCH DATA from:
custom-node-list.json
github-stats.json
ComfyUI-Manager
Failed to get custom node list
ConnectionError
SSLError
TimeoutError如果日志显示网络超时、SSL 或代理错误，请先修复连接问题。
如果显示本地缓存路径，说明 Manager 可能正在尝试读取缓存的注册表文件。
如果显示某个节点的 IMPORT FAILED，注册表列表问题可能只是次要症状。
第四步：区分缺失节点与缺失注册表条目
官方 Manager UI 可以在 Manager 已安装且能访问其列表的情况下，找到工作流中缺失的节点。
但某些工作流使用的节点未在 Manager 中注册。在这种情况下：
- Manager 可能找不到缺失的节点包
- 搜索可能没有有用的结果
- 安装所有缺失节点可能会失败
- 可能需要从作者的 GitHub 仓库手动安装
如果只有一个工作流失败，请检查红色节点的名称，并搜索工作流作者的页面或 README。如果许多工作流都失败，则更可能是 Manager 列表或网络访问的问题。
对于更安全的手动安装，请使用 如何在不破坏环境的情况下安装 ComfyUI 自定义节点。
第五步：仅在检查网络后才清除 Manager 缓存
如果 GitHub 和原始 GitHub 均可访问，但 Manager 仍无法加载列表，缓存可能已过期或损坏。
常见的缓存位置因安装类型和 Manager 版本而异。请在 ComfyUI 用户目录下查找 Manager 缓存文件，通常位于：
ComfyUI/user/default/ComfyUI-Manager/cache/
ComfyUI/user/__manager__/cache/你可能会看到如下名称的文件：
custom-node-list.json
github-stats.json
extension-node-map.json在删除任何内容之前：
- 停止 ComfyUI。
- 将缓存文件夹复制到安全位置。
- 仅删除 Manager 缓存文件，不要删除工作流、模型或自定义节点文件夹。
- 重启 ComfyUI。
- 再次打开 Manager。
如果同一网络无法访问注册表，清除缓存并不能修复根本原因。
第六步：在安装更多节点之前修复导入失败
如果启动日志中已经显示自定义节点导入失败，请不要继续点击安装。
查找：
IMPORT FAILED
ModuleNotFoundError
ImportError
No module named
AttributeError当存在导入失败时，更好的处理顺序是：
- 修复第一个导入失败。
- 重启 ComfyUI。
- 确认 Manager 可以打开。
- 然后重试缺失节点安装。
如果最近安装的自定义节点破坏了环境，请使用 安装自定义节点后破坏了 ComfyUI？无需重装即可恢复。
第七步：使用正确的 Python 环境
如果你手动安装或更新 Manager，请确保使用启动 ComfyUI 的同一 Python 环境。
对于 Windows 便携包，请避免使用系统 Python，而使用内嵌 Python：
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt对于手动安装或 venv 安装：
cd ComfyUI/custom_nodes/ComfyUI-Manager
pip install -r requirements.txt不要盲目运行 pip install -r requirements.txt。
- 确认当前激活的 Python 环境（
where python或which python） - 检查
requirements.txt——确认它是否固定了 torch、numpy 或 opencv 的版本 - 尽可能只安装缺失的包：
pip install <package-name> - 安装后运行
pip check以验证没有引入冲突
然后重启 ComfyUI 并检查第一个启动错误。
何时重装 Manager
仅在检查网络访问和缓存之后才重装 Manager。
对于手动安装，大致的恢复路径是：
cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git如果 ComfyUI-Manager 文件夹已经存在，不要盲目覆盖。停止 ComfyUI，备份该文件夹，然后有意识地进行更新或重装。
如果你使用的是 ComfyUI Desktop 或托管包，请使用该包的更新路径，而不是混入来自其他安装的随机文件。
为何此错误很重要
这个错误看起来很小，但它会破坏一个重要的工作流：
- 导入的工作流无法映射缺失节点
- Manager 搜索变得不可靠
- 新自定义节点的安装变成了碰运气
- 用户开始手动将包安装到错误的环境中
这就是一个简单的注册表问题如何演变为依赖漂移的过程。
相关 Manager 指南
- ComfyUI Manager：安装、打开、更新与故障排除
- 如何在不破坏环境的情况下安装 ComfyUI 自定义节点
- 如何修复 ComfyUI 插件导入失败错误
- 安装自定义节点后破坏了 ComfyUI？无需重装即可恢复
- ComfyUI 重连错误：原因与快速修复
Wonderful Launcher 如何提供帮助
当问题不再是"我该点击 Manager 中的哪个按钮？"时，Wonderful Launcher 最能发挥作用。
在以下情况下它会变得有用：
- 缺失节点持续出现
- Manager 和手动安装结果不一致
- 启动日志中包含多个导入失败
- 你需要保留模型和工作流
- 你希望优先走恢复路径，而不是随机执行
pip install命令
如果这台机器很重要，请在进行更多包修改之前先保护好环境。从 Wonderful Launcher 开始，检查日志、保持工作流状态可见，避免让注册表问题演变为依赖漂移。
来源参考
先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。
下载 Wonderful Launcher查看 credits 方案这篇文件解決了你的問题嗎？
你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。