ComfyUI Manager节点列表获取失败的终极自救手册两步修复KeyError快速告别空白页【免费下载链接】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-ManagerComfyUI Manager 是 ComfyUI 生态里最常用的节点管理插件负责自定义节点的安装、移除、禁用与更新。今天这篇文章要解决的是 Linux 环境下不少人被卡住的一个老大难问题——节点列表怎么都加载不出来控制台里还反复报KeyError: favorites。好消息是你不需要重装甚至不需要换网络跟着下面这两步走基本都能当场救回来。先别急着重装你可能只是踩了一个已知的坑很多人的第一反应是卸载重装但我得说一句先冷静一下。我印象特别深有一次我在 Linux 服务器上配好了整套 ComfyUI装完一批自定义节点后顺手更新了一下 Manager想着把新节点也补上。结果打开 Manager 一看自定义节点那块一直在转圈转了半天也没出东西。刷新几次、清掉浏览器缓存、甚至换了网络问题依旧。最后翻控制台日志看到一行刺眼的KeyError: favorites那一刻我意识到问题压根不在网络也不在我的操作。后来和社区里的朋友一聊才发现这套翻车剧本几乎人手一份。核心原因并不复杂Manager 的新版本和旧的数据格式之间出现了沟通障碍。快速自检你是不是也中招了在动手之前先用下面这份清单对号入座。如果你同时中了两条以上那恭喜或者说节哀你遇到了同一个坑节点管理界面一直显示加载中字样迟迟不给结果控制台里出现 JSON 解析相关的报错以及KeyError: favorites已经装好的节点在列表里集体失踪更新按钮形同虚设是不是全中没关系这正是今天要收拾的问题。第一步把版本切回被验证过的稳定提交如果你是在最近一次更新之后才开始出问题的那么最省事的操作就是先把代码回退到社区公认稳定的那个提交。在 ComfyUI 的custom_nodes/ComfyUI-Manager目录下执行cd /你的comfyui路径/custom_nodes/ComfyUI-Manager git checkout ca078e5这一行命令的意思是把当前版本回退到ca078e5这个 commit。它之所以被大家反复推荐是因为在很长一段时间里它都经受住了大量用户的实战检验稳定性和兼容性都相当能打。回退完成之后记得重启 ComfyUI 让改动生效。如果你是第一次部署、想直接装一个稳定版本也可以先通过下面的命令把仓库拉下来再切到同一个提交git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager cd ComfyUI-Manager git checkout ca078e5第二步把数据通道从本地缓存切到 remote版本回退只是第一步真正的一键解药在这里——进 Manager 的设置找到DB Channel选项把它从默认值改成 remote。为什么这个开关这么灵简单说改完之后 Manager 会强制走远程服务器拉取完整数据不再依赖本地那份可能过时的缓存从源头绕开缓存格式不兼容的问题拿到包含favorites等关键字段的完整数据结构KeyError自然就消失了很多教程到这里就结束了但我想多花点篇幅跟你聊聊这背后的原理。毕竟弄懂为什么比记住怎么改更有价值对吧知其所以然一个开关背后藏着什么默认情况下Manager 为了让你打开界面时能秒出列表会优先读取本地缓存。这个设计本身没毛病但它有个隐患缓存数据是有保鲜期的。当 Manager 完成版本迭代内部期望的数据结构发生变化之后本地那份旧缓存就成了前任留下来的信格式对不上新版的需求。于是当你去读它的时候发现里面根本没有favorites这个字段KeyError就顺理成章地爆了出来。把DB Channel切到 remote本质上是告诉 Manager别再翻旧账了直接去服务器问最新答案。这样一来数据完整、格式统一列表自然也就回来了。顺便说一句如果你对 DB Channel 背后的机制感兴趣或者想用命令行完成类似的操作项目里的docs/en/cm-cli.md这份文档写得很清楚值得翻一翻。三个能让你少走弯路的好习惯病治好了咱们也得防着复发。下面这三个习惯是我踩过坑之后总结出来的分享给你把 ComfyUI 装进虚拟环境Python 虚拟环境能帮你把不同项目的依赖彻底隔离开出问题时排查起来不知道省多少事。升级前备份 custom_nodes重要更新之前把custom_nodes目录整体复制一份。几秒钟的事却能让你在翻车时体面地全身而退。养成看更新日志的习惯项目根目录下的CHANGELOG.md会记录每次变更的细节尤其是数据结构一类的变化。提前了解就能避开不少惊喜。读者高频问题快问快答Q我已经切到了 remote但还是不行下一步该怎么办A按这个顺序排查先确认网络能正常访问官方数据源再清一次浏览器缓存最后重启 ComfyUI 服务。这三步都试完还不行再回头检查版本是否真的回退成功了。Q回退之后以后还能升级新版本吗A当然可以。但升级前记得先看看CHANGELOG.md里有没有提到缓存或数据结构相关的变更最好先备份custom_nodes再放行升级。Q换一台机器重新部署有没有更省心的办法A直接在干净的虚拟环境里部署装完 Manager 后第一时间把数据通道切到 remote基本上就能从一开始就绕开这个坑。写在最后说到底这个困扰无数人的节点列表加载失败解法并没有想象中复杂先回退稳定版本再把数据通道切到 remote两步走完绝大多数情况都能原地满血复活。下次再遇到节点列表空白先别慌着重装系统。按网络 → 浏览器缓存 → 版本回退的顺序排查一遍然后在 DB Channel 上动动手指——你会发现原来解决问题的钥匙一直都在设置面板里。【免费下载链接】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），仅供参考