ComfyUI 無法獲取自定義節點列表或 ComfyRegistry 列表修復

如果你搜尋了 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"，請從這裡開始：

1. 檢查正常的 ComfyUI 工作流是否仍能運行。
2. 在同一台機器上打開 Manager GitHub 頁面、ComfyRegistry 以及原始的 custom-node-list.json URL。
3. 不要根據註冊表錯誤信息中出現的詞語去安裝 Python 包。
4. 如果消息提到 ComfyRegistry、failed to fetch versions 或快取過期，請在修改插件之前先測試註冊表/原始 GitHub 的訪問情況。
5. 如果 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 試圖通過註冊表數據映射缺失的節點或包，但註冊表請求、快取列表或命名包查找失敗了。

請按以下順序處理：

1. 不要根據錯誤文本安裝隨機包。 缺失的字符串可能是註冊表包 ID，而不是 Python 包。
2. 如果同一消息出現在許多工作流或包中，請先檢查網絡訪問。
3. 僅在訪問正常後才清除 Manager 快取，如果錯誤提到快取過期或節點已被移除。
4. 如果只有一個工作流或一個註冊表包失敗，請手動搜尋確切的缺失節點或包名稱。
5. 如果資料夾存在但節點重啟後仍未註冊，請檢查插件匯入日誌。

如果錯誤中包含包名，例如 comfy-core、whatdreamscost-comfyui 或其他註冊表條目，請將該名稱視為 Manager 查找步驟的線索。這並不自動意味著 pip、Torch 或整個 ComfyUI 安裝已損壞。

如果此問題阻斷了缺失節點修復

當此錯誤出現在安裝缺失自定義節點過程中時，請在重試前先區分以下三種狀態：

不要將這三種情況都視為"重裝 Manager"。註冊表失敗、Git 克隆失敗和插件匯入失敗需要不同的修復方式。

快速診斷

錯誤的實際涵義

ComfyUI Manager 依賴於註冊表列表。官方 ComfyUI 文檔將 Manager 描述為用於搜尋、安裝、更新和管理自定義節點（包括從匯入工作流中缺失的節點）的工具。

對於節點作者，官方發布文檔也將 custom-node-list.json 作為節點必須出現其中的註冊表，以便 Manager 能夠發現它。如果 Manager 無法拉取或讀取這些數據，它可能無法知道哪個自定義節點包與你工作流中缺失的節點對應。

這就是為什麼當你點擊以下選項時，該消息經常出現：

• 安裝缺失自定義節點
• Manager
• 搜尋節點
• 更新節點

這並不總是意味著 ComfyUI 本身已損壞。

第一步：檢查 ComfyUI 是否仍能運行

首先回答以下問題：

1. 默認工作流是否仍能加載？
2. 能否排隊一個簡單的圖像任務？
3. 已安裝的自定義節點是否仍然顯示？
4. 唯一損壞的功能是 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

在刪除任何內容之前：

1. 停止 ComfyUI。
2. 將快取資料夾複製到安全位置。
3. 僅刪除 Manager 快取文件，不要刪除工作流、模型或自定義節點資料夾。
4. 重啟 ComfyUI。
5. 再次打開 Manager。

如果同一網絡無法訪問註冊表，清除快取並不能修復根本原因。

第六步：在安裝更多節點之前修復匯入失敗

如果啟動日誌中已經顯示自定義節點匯入失敗，請不要繼續點擊安裝。

查找：

IMPORT FAILED
ModuleNotFoundError
ImportError
No module named
AttributeError

當存在匯入失敗時，更好的處理順序是：

1. 修復第一個匯入失敗。
2. 重啟 ComfyUI。
3. 確認 Manager 可以打開。
4. 然後重試缺失節點安裝。

如果最近安裝的自定義節點破壞了環境，請使用 安裝自定義節點後破壞了 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

何時重裝 Manager

僅在檢查網絡訪問和快取之後才重裝 Manager。

對於手動安裝，大致的恢復路徑是：

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git

如果 ComfyUI-Manager 資料夾已經存在，不要盲目覆蓋。停止 ComfyUI，備份該資料夾，然後有意識地進行更新或重裝。

相關 Manager 指南

• ComfyUI Manager：安裝、打開、更新與故障排除
• 如何在不破壞環境的情況下安裝 ComfyUI 自定義節點
• 如何修復 ComfyUI 插件匯入失敗錯誤
• 安裝自定義節點後破壞了 ComfyUI？無需重裝即可恢復
• ComfyUI 重連錯誤：原因與快速修復

參考來源

• 官方 ComfyUI Manager 自定義節點管理指南
• 官方 ComfyUI 自定義節點安裝指南
• 官方 ComfyUI Manager 發布文檔
• GitHub 上的 ComfyUI-Manager custom-node-list.json