常见报错与坑点汇总：ComfyUI 避坑指南

在使用 ComfyUI 的过程中，报错是家常便饭。别怕，90% 的问题都有固定解法。

1. 节点爆红 (Red Node)

现象: 打开工作流，某个节点变成红色，且无法运行。 原因:

1. 缺少插件: 节点是别人装的插件里的。
   • 解法: Manager -> Install Missing Custom Nodes。
2. 加载失败: 比如 Load Checkpoint 选中的模型你没下载。
   • 解法: 点击节点，重新选择一个你有的模型。

2. CUDA Out of Memory (显存不足)

现象: 运行到一半报错 CUDA out of memory。 解法:

1. 降低分辨率: 512x512 是最安全的。
2. 减小 Batch Size: 一次只生一张。
3. 启动参数: 在启动脚本 (run_nvidia_gpu.bat) 中添加 --lowvram (极低显存模式) 或 --medvram。
4. 清理后台: 关闭浏览器、PS 等占用显存的软件。

3. 生成全黑 / 雪花屏 / 噪点图

原因: VAE 错误！

• 用 SD1.5 的模型挂了 SDXL 的 VAE。
• 用 SDXL 的模型挂了 SD1.5 的 VAE。
• 忘记挂 VAE。 解法: 检查 VAE Decode 的来源，确保与 Checkpoint 匹配。

4. 连接端口不匹配

现象: 拖动连线连不上。 原因: 类型不同。

• 不能把 IMAGE (像素) 连给 LATENT (潜空间)。
• 不能把 STRING (字符串) 连给 INT (整数)。 解法: 思考你需要什么转换。比如 IMAGE -> LATENT 需要 VAE Encode。

5. 插件冲突

现象: 启动时控制台狂刷报错，或者界面加载不出来。 解法:

• 进 custom_nodes 目录，把最近安装的插件文件夹删掉。
• 或者运行 update 脚本更新所有插件到最新版。

结语

ComfyUI 的学习之路就像一场修行。从最初的满屏红框，到最后的信手拈来，你不仅学会了一个工具，更深刻理解了 AI 思考的方式。 希望这 20 篇教程能成为你通往 AI 艺术大师之路的基石。加油！