ComfyUI Manager 节点列表加载失败的完整排查路线图：从报错定位到数据源切换一键恢复

ComfyUI Manager 节点列表加载失败的完整排查路线图：从报错定位到数据源切换一键恢复

【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager

如果你正在使用 ComfyUI Manager 管理自定义节点，却遇到列表迟迟加载不出、控制台频繁抛出KeyError: 'favorites'这类异常，这篇文章就是为你准备的。我们不做"玄学修复"，而是沿着一条清晰的排查路线，逐步定位根因，再用最小改动让节点管理界面恢复如常。

第一章 先看清症状：把报错当作线索而非障碍 🎯

遇到问题别急着回退版本或重装插件，第一步永远是"读日志"。当节点列表空白时，打开 ComfyUI 的运行终端，向上翻找，通常能看到类似下面的记录：

[ComfyUI-Manager] DB item is broken KeyError: 'favorites'

这条报错恰恰是理解问题的钥匙。在 ComfyUI Manager 的源码里，收藏字段的填充逻辑是这样的：

def populate_favorites(node_packs, json_obj_extras): favorites = set(json_obj_extras['favorites']) # 直接取 key，数据缺字段就会崩

json_obj_extras来自一份名为extras.json的远程数据文件。只要这份数据里没有favorites键，上面的代码就会当场抛异常，整个列表也就渲染不出来。所以，问题不在你的电脑，而在"喂给 Manager 的那份数据"上。

小提示：如果在日志里看到network error, switching to local mode，说明 Manager 已经因网络异常自动降级到本地模式了——这往往就是"缺字段"数据的来源。

第二章 追根溯源：一份 JSON 数据的三段旅程 💡

为什么数据会"缺字段"？要回答这个问题，得看懂 ComfyUI Manager 获取节点数据的完整链路。核心入口是get_data_by_mode，它根据你选择的DB Channel（数据通道）决定从哪取数：

• local 模式：直接读取项目目录下的本地 JSON 文件，不联网；
• cache 模式：优先读缓存目录.cache里的文件，若缓存超过一天则联网刷新；
• remote 模式：强制从远端通道拉取最新数据，再写入缓存。

问题的根源在于版本错位：旧版本的缓存文件、或本地残留的数据文件，字段结构与新版 Manager 期待的结构不一致。新代码要读favorites，旧数据里却没有这个字段，KeyError自然就冒出来了。

更隐蔽的是，get_data_by_mode在联网失败时会自动回退到本地文件（源码中对应except分支），于是你表面上用的是 remote，实际拿到的却是过期数据。这就是"明明切了远程还是报错"的真相。

第三章 三层递进方案：由轻到重，逐级修复 🔧

我们按"代价从小到大"的顺序给出方案，每做完一步就刷新页面验证一次，不要跳级。

第一步：清空缓存，强制重取

缓存是"缺字段"数据的头号藏身点。找到 ComfyUI-Manager 插件目录下的.cache文件夹，把里面的 JSON 缓存文件移走（建议备份而不是删除），然后重启 ComfyUI。这一步能解决约一半的缓存污染问题。

第二步：切换数据源通道

打开 ComfyUI Manager 的设置界面，找到DB Channel选项，将其改为remote：

设置 → DB Channel → 切换为 remote → 重启 ComfyUI

remote 模式会绕过本地文件、绕过一天内的缓存，直接向远端请求完整的extras.json，确保favorites等关键字段完整。这也是社区验证过的最有效一步。

第三步：回退到已验证的稳定版本

如果你最近刚更新过 Manager，且前两步无效，可以把插件回退到社区广泛验证的稳定版本：

cd /data/web/disk1/git_repo/gh_mirrors/co/ComfyUI-Manager git checkout ca078e5 # 该提交经大量用户验证可稳定运行

常见误区：很多人一上来就git pull到最新版，反而更容易触发数据结构不兼容。先修数据源，再谈版本，顺序别搞反。

第四章 高频疑问快答：三个容易踩的坑 ⚠️

问：切了 remote 模式，为什么还是报错？

答：请确认缓存已清理，且切换后完整重启了服务。若依然报错，多半是网络层面拿不到远端文件，Manager 静默回退到了本地模式——检查终端里是否有switching to local mode的提示。

问：.cache目录可以直接删除吗？

答：可以，但更稳妥的做法是移到别处。缓存只是加速手段，缺失后 Manager 会自动重建，不会影响已安装的节点本体。

问：只有favorites这一个字段会出问题吗？

答：不会。凡是直接json_obj['xxx']形式取值的字段都有风险，favorites只是最常见的一个。所以"数据源与代码版本保持同步"才是治本之道。

第五章 把问题挡在门外：三件小事的长期价值 🚀

一位在群里分享经验的用户说得很实在："以前遇到节点列表空白，我第一反应是重装插件，后来才明白，99% 的情况换一下数据通道再清个缓存就解决了，根本不用大动干戈。"

想少折腾，日常做好三件事：

1. 更新前先备份：把custom_nodes/ComfyUI-Manager目录整体压缩一份，回退时直接解压覆盖；
2. 更新后留意日志：升级 Manager 后第一次启动时，盯一眼终端是否出现 JSON 解析异常；
3. 网络不稳定时主动用 cache：先切 cache 模式让数据落地，再切 remote 验证完整性，两不误。

---

回顾整条路线：从日志定位KeyError: 'favorites'，到理解数据通道的取数逻辑，再到"清缓存 → 切 remote → 回退版本"的三级递进修复，我们已经把 ComfyUI Manager 节点列表加载失败这条链路彻底走通了。下次再遇到节点列表空白，你不再是"碰运气式修复"，而是心里有了一张清晰的作战地图。照着我们说的顺序试一遍，你的节点管理界面很快就能恢复如常。🌟

【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager