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 → 重启 ComfyUIremote 模式会绕过本地文件、绕过一天内的缓存直接向远端请求完整的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% 的情况换一下数据通道再清个缓存就解决了根本不用大动干戈。想少折腾日常做好三件事更新前先备份把custom_nodes/ComfyUI-Manager目录整体压缩一份回退时直接解压覆盖更新后留意日志升级 Manager 后第一次启动时盯一眼终端是否出现 JSON 解析异常网络不稳定时主动用 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考