ComfyUI 满屏红节点、工作流跑不动?别瞎删,按这个顺序排查

兴冲冲下了个别人的 ComfyUI 工作流,拖进去一看——好家伙,半屏的节点全红了,旁边还飘着一串红字。或者节点都正常,一点 Queue 就崩。这是几乎每个 ComfyUI 玩家都会撞上的坎。

　　别急着把红节点一个个删掉,删了你这流程就废了。报错其实分几种,病因不一样,治法也不一样。下面按”最常见、最好治”到”最麻烦”的顺序给你排一遍,照着走基本能定位。

第一种:节点变红、提示 Missing Node Types

　　这是最常见的,十次有七八次是它。红节点配上 “Missing Node Types” 或者节点显示成 UNKNOWN,意思很简单:这个工作流用到了某些自定义节点(插件),而你本地没装。

　　治它的标准动作:装好 ComfyUI Manager(这是 ComfyUI 第一个该装的工具,没有的先去装),然后点菜单里的 Manager → Install Missing Custom Nodes。它会自动扫出你缺哪些节点,列出来,你点安装就行。装完一定要彻底重启 ComfyUI(不是刷新网页,是把后台那个命令行窗口也关掉重开),不然新节点不生效,你还以为没装上。

　　这里有个国内特有的坑:Manager 下载节点经常因为网络问题卡住或失败。要是反复装不上,就得学会手动装——找到那个节点的 GitHub 地址,把仓库 clone 或下载下来,丢进 ComfyUI 安装目录的 custom_nodes 文件夹里,再重启。手动装是 ComfyUI 的必备技能,躲不掉。

第二种:插件明明装了,还是报红 / UNKNOWN

　　这种最气人,Manager 里明明显示装了,节点还是红的。常见于 Windows 的 ComfyUI Desktop 版。原因通常是:依赖没装对,或者你装的目录根本不是程序实际在读的那个数据目录(Desktop 版的数据目录和你以为的位置经常对不上)。

　　排查思路:先确认程序真正在用的 custom_nodes 到底是哪个文件夹(看启动日志里打印的路径最准),把装错位置的、报错的插件目录清掉,重新 git clone 到正确目录,然后用它自带的 .venv 环境去 pip install -r requirements.txt 把依赖补齐。说白了就是:位置要对、依赖要全、环境别串。

第三种:节点都正常,一跑就崩

　　如果节点不红,是点了执行才报错,那多半是这两类:

• 连线接错或参数不对:比如 VAE 没接、latent 尺寸对不上、模型和工作流不配套。顺着报红的那个节点往上看它的输入,十有八九是某根线没连或连歪了。
• 显存不足(OOM):控制台出现 CUDA out of memory 就是它。先把出图分辨率、批量降下来;实在不行,启动时加省显存的参数,或者上分块(Tiled)类节点把大图拆开算。

一个万能兜底:看控制台

　　不管哪种报错,真正的病因都写在后台那个黑色命令行窗口里,网页上的红字只是冰山一角。看不懂没关系,把最后那几行红字(尤其是 Error 开头的)复制下来,丢给搜索或者 AI,八成能查到对症的解法。很多人卡半天,其实答案就明晃晃印在控制台里,只是没去看。

　　把顺序记一下:先用 Manager 补缺失节点 → 装了还红就查目录和依赖 → 节点没问题就看连线和显存 → 实在搞不定,复制控制台红字去搜。一套走下来,绝大多数报红都能收拾干净。