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

AI智能摘要

ComfyUI工作流报红（Missing Node Types）时，先用ComfyUI Manager的“Install Missing Custom Nodes”自动补装；若仍无效，需手动将插件GitHub仓库克隆到正确custom_nodes目录并补全依赖（pip install -r requirements.txt）。节点正常但运行崩溃，则检查连线错误或显存不足（CUDA out of memory），降低分辨率或使用分块节点。所有报错的根本原因都记录在后台控制台错误日志中，复制关键词搜索即可定位。

— 此摘要由AI分析文章内容生成，仅供参考。

兴冲冲下了个别人的 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)类节点把大图拆开算。