ComfyUI FLUX 常见报错怎么排查？红色节点、模型找不到、OOM、没有输出图整理

先说结论

ComfyUI 报错不要一上来就重装。大多数情况下，出问题不是因为 ComfyUI 坏了，而是某个环节没接上。

请按这个顺序分清楚是哪一类：

节点问题——红色节点、missing custom node
模型路径问题——下拉框为空、文件放错目录
工作流连接问题——Queue Prompt 点不了、节点断线
显存问题——CUDA out of memory、显存占用异常
输出保存问题——运行完了但找不到图
seed / 参数对比问题——每次结果都不一样

这篇文章不是替代前面 19 篇详细文章，而是作为一个快速排查入口——看现象、对号入座、点进对应的详细文章。

这篇文章适合谁

刚导入 FLUX GGUF 工作流就报错
红色节点不知道什么意思
模型下拉框为空，不知道文件放哪里
Queue Prompt 点不了或点了没反应
运行结束但 output 里没有图
OOM 后不知道该先降哪个参数
RTX 4060 Laptop 8GB 跑 FLUX GGUF 的新手

我的测试环境

项目	参数
GPU	NVIDIA GeForce RTX 4060 Laptop GPU
专用显存	8GB
系统内存	32GB
系统	Windows 11
ComfyUI	0.24.0
方案	FLUX GGUF Q6_K + T5 FP8
UNet	flux1-dev-Q6_K.gguf
Text Encoder	t5xxl_fp8_e4m3fn_scaled.safetensors + clip_l.safetensors
VAE	ae.safetensors
默认参数	1024x1024, 20/30 steps, batch 1, CFG 1.0, euler, simple

排查顺序总览

新手遇到报错，建议按这个顺序排查，不要跳步骤：

看有没有红色节点
看模型下拉框有没有内容
看模型文件是否放对目录
看节点之间有没有断线
看 Queue Prompt 是否能点
看控制台有没有报错关键词
看 output 文件夹有没有图
看任务管理器专用 GPU 内存
降分辨率、batch 固定 1 重新测试
以上都不行再考虑重启 ComfyUI 或电脑

现象 1：红色节点

这是什么

节点变成红色，通常不是显存问题，而是 ComfyUI 不认识这个节点。

常见原因

custom node 没安装
安装后没重启 ComfyUI
工作流来自别人的环境，节点版本不一致
节点名字拼写不匹配

怎么处理

先看红色节点的标题是什么
用 ComfyUI Manager 搜索对应的 custom node
安装后务必重启 ComfyUI
如果是 Unet Loader (GGUF) 变红，先检查 ComfyUI-GGUF 是否安装

详细文章：ComfyUI 工作流 JSON 怎么导入？红色节点、缺失节点、模型找不到怎么办和 ComfyUI-GGUF 节点怎么安装？。

现象 2：Unet Loader (GGUF) 找不到

FLUX GGUF 工作流不能用普通的 Load Checkpoint 或 UNET Loader 直接加载 GGUF 文件。

如果节点列表里找不到 Unet Loader (GGUF)，按这个顺序检查：

确认 ComfyUI-GGUF 已安装
确认安装后重启了 ComfyUI
确认 GGUF 文件放在 models/unet/，而不是 models/checkpoints/

详细文章：ComfyUI-GGUF 节点怎么安装？和 FLUX GGUF 和 safetensors / checkpoint 有什么区别？。

现象 3：模型下拉框为空

GGUF 找不到

检查文件是否放在：models/unet/

T5 / CLIP 找不到

检查文件是否放在：models/text_encoders/

VAE 找不到

检查文件是否放在：models/vae/

文件放进去以后，最好刷新模型列表或重启 ComfyUI。下拉框还不出现的话，检查文件名和扩展名是否有拼写错误。

详细文章：ComfyUI FLUX 模型文件放哪里？UNet、T5、CLIP、VAE 目录对照。

现象 4：Queue Prompt 点不了

常见原因：

红色节点还没解决
节点里的模型还没选
KSampler 缺少必要的输入连接
VAE Decode 没有接好
EmptySD3LatentImage 的分辨率设置有问题
工作流导入不完整，缺少某些节点

建议：先不要调显存参数。先把红色节点和模型选项检查完，确认每个节点的输入输出都连上了。

现象 5：运行后没有图片输出

这是新手最容易困惑的情况之一——明明 Queue Prompt 跑完了，但不知道图在哪。

常见原因：

Save Image 没有接到 IMAGE（接的是 LATENT 或其他输出）
工作流里只用了 Preview Image，没用 Save Image
Save Image 的 filename_prefix 太乱，分不清哪张是新图
看错了 ComfyUI 的安装目录，找错了 output 文件夹
工作流运行中途报错中断，图没生成

怎么检查：

确认 VAE Decode 的 IMAGE 输出接到了 Save Image 的 images 输入
打开 ComfyUI 安装目录下的 output 文件夹
按「修改时间」排序，找最新的 PNG
检查 Save Image 节点的 filename_prefix，看生成的图是否匹配

详细文章：ComfyUI FLUX 出图保存在哪里？output 文件夹、Save Image 节点和文件名前缀说明。

现象 6：CUDA out of memory / OOM

OOM 是显存不够。8GB 显卡跑 FLUX 时，优先排查这些：

分辨率是否太高（先降到 768x768 测试）
batch_size 是否大于 1（必须用 1）
是否用了原版 FP16 UNet 而非 GGUF
T5 是否用了全精度而非 FP8
Chrome / Discord / Steam / 录屏是否占用了显存
显存是否被上一次运行残留占用

建议排查顺序：

batch_size 固定 1
分辨率先降到 768x768 测试是否正常
关闭浏览器多余页面、录屏、游戏、Discord、Steam
看任务管理器专用 GPU 内存使用量
重启 ComfyUI
仍不行再重启电脑

详细文章：ComfyUI FLUX 8GB 显存不够怎么办？OOM、加载慢、爆显存排查记录、GPU 显存怎么看、显存不释放怎么办。

现象 7：第一次出图特别慢

第一次 Queue Prompt 特别慢，不一定是卡死了，很可能只是冷启动：模型需要从硬盘加载到显存。

不要一看到慢就关掉重来——如果控制台还在输出日志，说明正在加载。但如果长时间（比如超过 5~10 分钟）没有任何日志变化，再考虑排查。

详细文章：ComfyUI FLUX 第一次出图很慢怎么办？冷启动、模型加载、缓存占用解释。

现象 8：GPU 使用率 0%，但显存很高

这不是矛盾。GPU 使用率反映的是计算核心在不在忙，专用 GPU 内存反映的是显存里还有多少数据。

出图结束后，计算核心空闲（使用率 0%），但模型可能还在显存里驻留（显存占用高）——这是正常的。

详细文章：ComfyUI FLUX 8GB 显存占用怎么看？任务管理器、专用 GPU 内存、共享 GPU 内存区别。

现象 9：显存占用不释放

跑完图后显存不一定马上下降。如果下一张还能正常生成，不一定需要处理。

如果连续 OOM 或者显存越涨越高，再考虑：

关闭 ComfyUI 网页
关闭启动 ComfyUI 的终端/Python 进程
重启电脑（以上都不行时）

详细文章：ComfyUI FLUX 显存占用不释放怎么办？重启、清缓存、关闭后台程序排查记录。

现象 10：同一个 prompt 每次结果不同

这通常不是 bug，而是 seed 在起作用。

想每次探索新图：用 randomize
想复现某张图：用 fixed，记下 seed 数字
想做 steps、分辨率、prompt 对比：必须 fixed

详细文章：ComfyUI FLUX seed 怎么设置？fixed、randomize、复现同一张图的实测记录。

新手不要一上来做的事

这些是我在排查过程中踩过的坑，新手阶段建议先避开：

直接重装 ComfyUI（大部分问题不需要重装）
把所有模型乱放到 checkpoints
一边改 prompt 一边改 seed 一边改分辨率（不知道画面变化来自哪里）
看到红色节点就以为是显存不够
OOM 后先去改 seed
不看控制台报错信息
不看 output 文件夹，以为没生成图
一上来就 1280x1280 或 batch 2

快速对照表

现象	先查什么	对应文章
红色节点	custom node 是否安装	JSON 导入排查
Unet Loader (GGUF) 找不到	ComfyUI-GGUF 是否安装	GGUF 节点安装
模型下拉框为空	文件目录	模型文件目录
Queue Prompt 点不了	节点连接 / 模型选择	工作流搭建
运行完没有图	Save Image / output 目录	出图保存位置
CUDA out of memory	显存 / 分辨率 / batch	OOM 排查
显存使用量很高	任务管理器专用 GPU 内存	GPU 显存怎么看
显存不释放	关闭 ComfyUI 后台进程	显存不释放
第一次特别慢	冷启动	第一次出图很慢
每次结果不同	seed 设置	seed 设置

FAQ

红色节点是不是显存不够？

不是。红色节点说明 ComfyUI 不认识这个节点类型，通常是 custom node 没装或没重启，和显存没有直接关系。

为什么 GGUF 放进 checkpoints 还是找不到？

因为 Load Checkpoint 不能加载 GGUF。GGUF 文件应该放 models/unet/，用 Unet Loader (GGUF) 加载。

Load Checkpoint 能不能加载 GGUF？

不能。FLUX GGUF 工作流需要 Unet Loader (GGUF)，这是 ComfyUI-GGUF 提供的节点。

Queue Prompt 点不了应该先查什么？

先看有没有红色节点、节点里的模型是否已选择、KSampler 的输入是否齐全。

为什么运行完没有图片？

优先检查 Save Image 是否接到 VAE Decode 的 IMAGE 输出，然后去 ComfyUI/output 文件夹找。

OOM 后是不是必须重启电脑？

不一定要。大多数情况先降分辨率、关浏览器、确认 batch=1、重启 ComfyUI 就够了。还不行再重启电脑。

GPU 0% 为什么显存还很高？

使用率看的是计算核心是否在忙，显存看的是数据是否还驻留在 GPU 内存里。两者是独立指标。

同一个 prompt 为什么图不一样？

因为 seed 在变。想复现就固定 seed，想探索就用 randomize。

后续待测

常见报错截图整理（后续可能补一个图文版）
ComfyUI Manager 自动安装缺失节点的稳定性
不同 FLUX 工作流导入同一环境的节点差异
低显存下连续出图的稳定性测试
同一报错在不同 ComfyUI 版本中的表现差异