满屏红字,是每个 ComfyUI 新手都会被吓到的瞬间。但好消息是:ComfyUI 的报错其实相当直白,它通常已经把问题写在字面上了,只是用英文、夹着几个技术名词,看起来吓人而已。

下面 10 个是出现频率最高的报错。直接照报错里的关键词对照,不用通读全部。

报错关键词它真正想说解法
CUDA out of memory / OutOfMemoryError显存爆了先降分辨率;启动参数加 --lowvram;关掉其他占用显存的程序;SDXL 换回 SD1.5
The following models are missing这个工作流要用的模型你没下按提示的模型名去下载,或用同类型模型替代后在节点里手改选择
Prompt outputs failed validation节点之间连线接错了看连线两端的数据类型(IMAGE / MASK / LATENT / CONDITIONING),删掉错线重连
No module named 'xxx'缺 Python 依赖包用 ComfyUI 自己那个 Python 环境去装,别用系统 Python,否则装了也读不到
Redefinition of ...自定义节点装重复了到 custom_nodes 目录删掉重复的那一份,重启即可
ImportError: DLL load failedtorch 与 CUDA 版本跟显卡驱动对不上(Windows 高发)装与驱动匹配的 torch+cu 组合版本,别混装不同 cu 版本
Address already in use8188 端口被占,多半是上一个进程没退干净任务管理器结束残留的 python 进程,或换端口启动
got an unexpected keyword argument节点版本太旧,主程序已经改了接口用 Manager 把自定义节点全部更新一遍
PermissionError没有写权限(无管理员环境高发)把 ComfyUI 与输出目录整体移到你有写权限的盘,别放受保护目录
FileNotFoundError: ...safetensors模型路径填错模型必须放在 ComfyUI/models/ 下对应的子目录(checkpoints / loras / vae 各归各位)

拿到一段没见过的报错,按这三步看

  1. 只看最后一行——真正的原因通常在最后,前面几十行多半是调用栈;
  2. 找里面的文件名和模型名——报错里提到的 .safetensors 或节点名,直接指向出问题的那个东西;
  3. 先假设它属于三类之一:缺模型、显存爆、节点冲突。这三类占了九成,用排除法比逐字读快得多。

一个能省很多时间的习惯

每次装新节点、换模型前,先把当前能跑通的这套整体复制一份。出问题时切回去就能继续干活,不用在报错里耗一下午。对无管理员权限的环境尤其重要——因为你连"重装一遍"这条路都走得比别人慢。

报错不是敌人,它是唯一会告诉你确切原因的东西。把这张表存下来,下次红字出现时直接对照查,比到处问人快得多。想把这些坑一次性绕开,《ComfyUI 无痛安装与避坑指南》里有完整的逐行配置与常见冲突清单。