满屏红字,是每个 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 failed | torch 与 CUDA 版本跟显卡驱动对不上(Windows 高发) | 装与驱动匹配的 torch+cu 组合版本,别混装不同 cu 版本 |
Address already in use | 8188 端口被占,多半是上一个进程没退干净 | 任务管理器结束残留的 python 进程,或换端口启动 |
got an unexpected keyword argument | 节点版本太旧,主程序已经改了接口 | 用 Manager 把自定义节点全部更新一遍 |
PermissionError | 没有写权限(无管理员环境高发) | 把 ComfyUI 与输出目录整体移到你有写权限的盘,别放受保护目录 |
FileNotFoundError: ...safetensors | 模型路径填错 | 模型必须放在 ComfyUI/models/ 下对应的子目录(checkpoints / loras / vae 各归各位) |
拿到一段没见过的报错,按这三步看
- 只看最后一行——真正的原因通常在最后,前面几十行多半是调用栈;
- 找里面的文件名和模型名——报错里提到的 .safetensors 或节点名,直接指向出问题的那个东西;
- 先假设它属于三类之一:缺模型、显存爆、节点冲突。这三类占了九成,用排除法比逐字读快得多。
一个能省很多时间的习惯
每次装新节点、换模型前,先把当前能跑通的这套整体复制一份。出问题时切回去就能继续干活,不用在报错里耗一下午。对无管理员权限的环境尤其重要——因为你连"重装一遍"这条路都走得比别人慢。
报错不是敌人,它是唯一会告诉你确切原因的东西。把这张表存下来,下次红字出现时直接对照查,比到处问人快得多。想把这些坑一次性绕开,《ComfyUI 无痛安装与避坑指南》里有完整的逐行配置与常见冲突清单。