← ComfyUI 实测笔记

ComfyUI 工作流 JSON 怎么导入？红色节点、缺失节点、模型找不到怎么办

ComfyUIFLUXGGUFworkflowJSONtroubleshootingbeginner

先说结论

导入别人的 ComfyUI 工作流 JSON 后不能直接出图，最常见的不是显卡问题，而是：

  • 缺少自定义节点，节点变红
  • 模型文件没放对目录，下拉框为空
  • 节点里还没有重新选择模型
  • 工作流使用的节点名称和你的本地版本不一致
  • Save Image 没有接到最终图像

不要一看到红色节点就去改显存参数——这是两回事。

这是我在 RTX 4060 Laptop 8GB + FLUX GGUF Q6_K + T5 FP8 上的实测记录，不是官方文档。

这篇文章适合谁

  • 下载了别人给的 ComfyUI workflow JSON，不知道怎么用
  • 导入后出现红色节点，不知道什么意思
  • Queue Prompt 点不了或运行就报错
  • 模型下拉框里没有 GGUF / T5 / VAE
  • 不知道哪些问题是节点问题，哪些是模型路径问题

我的测试环境

项目配置
GPUNVIDIA GeForce RTX 4060 Laptop GPU
专用显存8GB
系统内存32GB
ComfyUI0.24.0
方案FLUX GGUF Q6_K + T5 FP8
UNetflux1-dev-Q6_K.gguf
Text Encodert5xxl_fp8_e4m3fn_scaled.safetensors + clip_l.safetensors
VAEae.safetensors
默认采样1024x1024, batch 1, CFG 1.0, euler, simple

ComfyUI 工作流 JSON 怎么导入

三种方式，效果一样：

  1. 拖拽导入：直接把 .json 文件拖进 ComfyUI 浏览器页面。
  2. Load 按钮：点击 ComfyUI 界面上的 Load 按钮，选择 JSON 文件。
  3. 粘贴导入：复制 JSON 内容，在 ComfyUI 里 Ctrl+V 粘贴。

重要： 导入只是把节点摆到画布上，不代表你的本地环境已经安装好这些节点和模型。导入成功 ≠ 能跑通。

导入后先看什么

按这个顺序检查，不要跳：

  1. 有没有红色节点
  2. 节点标题是否显示 “Missing” 字样
  3. 模型下拉框是否为空（显示 “Select…” 或空白）
  4. KSampler 前后连线是否完整
  5. VAE Decode 是否接到 Save Image
  6. Queue Prompt 按钮是否能点击
  7. 控制台有没有红色报错

先解决节点问题，再解决模型问题，最后才动参数。

红色节点是什么意思

红色节点表示 ComfyUI 不认识这个节点类型。常见原因：

  • 缺少对应的 custom node（自定义节点插件）
  • 自定义节点版本和你的 ComfyUI 不匹配
  • 节点名称在不同版本中改变了

举例： 如果 Unet Loader (GGUF) 是红色，通常说明 ComfyUI-GGUF 没装好，或者安装后没有重启 ComfyUI。

红色节点 ≠ 显存不够 ≠ GPU 问题。 不要一看到红色就去调 --lowvram 或降分辨率。

Missing custom node 怎么办

步骤：

  1. 看红色节点的标题，记下名字。
  2. 打开 ComfyUI-Manager，点 Install Missing Custom Nodes。
  3. 如果 Manager 自动识别到缺失节点，直接安装。
  4. 安装完成后，重启 ComfyUI。
  5. 重启后重新加载 JSON，检查节点是否还是红色。

如果 Manager 没有自动识别，说明这个节点可能来自比较小众的插件。去 custom_nodes/ 目录手动检查，或者问 JSON 的提供者用了哪些插件。

强调： 节点缺失是环境问题，OOM 是显存问题。两者不要混在一起排查。

Unet Loader (GGUF) 找不到怎么办

如果你导入的是 FLUX GGUF 工作流，节点列表里却找不到 Unet Loader (GGUF)，原因通常是：

  • ComfyUI-GGUF 插件没有安装
  • 安装后没有重启 ComfyUI
  • 插件版本不兼容

不要用 Load Checkpoint 节点去加载 GGUF 文件。 Load Checkpoint 不认识 .gguf 格式。GGUF 文件有专属的加载节点。

详见：ComfyUI-GGUF 节点怎么安装？ 和 GGUF vs safetensors / checkpoint 区别

模型下拉框为空怎么办

即使节点都正常（不红），下拉框里也可能没有模型可选。分情况处理：

GGUF 找不到

  • 放错目录：GGUF 应放 models/unet/，不是 models/checkpoints/。
  • 文件扩展名：确认文件名是 .gguf。
  • 没刷新：放完文件后点 ComfyUI 的 Refresh 按钮，或重启 ComfyUI。

T5 / CLIP 找不到

  • 放错目录：应放 models/text_encoders/，不是 models/clip/。
  • 少文件：DualCLIPLoader 需要两个文件——T5 FP8 和 clip_l。缺一个，节点下拉框里也会不完整。

VAE 找不到

  • 应放 models/vae/。
  • 确认文件名是 ae.safetensors，且扩展名正确。

详见：ComfyUI FLUX 模型文件放哪里？

导入后为什么还要重新选模型

别人的 JSON 里记录的模型名称可能和你本地的不一样。即使文件放对了目录，节点里可能仍然显示为空或显示旧名称。

每次导入新工作流，都要在关键节点的下拉框里重新选择你本地的模型文件。 尤其是：

  • Unet Loader (GGUF) — 重新选你的 GGUF 文件
  • DualCLIPLoader — 重新选 T5 和 CLIP
  • VAELoader — 重新选 VAE

这不是工作流有问题，是模型文件路径和名称没有自动映射。

Queue Prompt 不能运行的常见原因

如果节点不红、模型也选了，但 Queue Prompt 点不了或运行报错：

  1. 红色节点还没完全解决（可能有节点只是标题没红但连线断了）
  2. 模型下拉框仍然为空（虽然文件放对了，但节点没有重新选择）
  3. KSampler 输入缺失——检查 MODEL、GUIDER、SIGMAS、LATENT 四个输入是否都接了
  4. VAE Decode 没有接好——KSampler 输出 samples 接到 VAE Decode，VAE Decode 还要接 VAE 模型
  5. EmptySD3LatentImage 分辨率设置过高导致显存不够
  6. batch_size 不是 1
  7. Save Image 接的是 LATENT 而不是 IMAGE（中间缺 VAE Decode）

FLUX GGUF 最小工作流检查清单

如果你不确定一个 FLUX GGUF 工作流是否完整，用这个清单逐项核对：

节点检查项断了会怎样
Unet Loader (GGUF)是否选了 GGUF 文件KSampler 无 MODEL 输入
DualCLIPLoadertype 是否选了 flux，两个文件都选了吗CLIP 文本编码无输入
CLIP Text Encode (Flux)是否接到 DualCLIPLoader 的 CLIP 输出BasicGuider 无 CONDITIONING
EmptySD3LatentImage分辨率是否合理，batch_size 是否为 1KSampler 无 LATENT
BasicGuiderCONDITIONING 和 LATENT 是否接对KSampler 无 GUIDER
KSampler四个输入是否全接上采样不执行
BasicScheduler是否接到 KSamplerKSampler 无 SIGMAS
RandomNoise是否接到 KSamplerKSampler 无 NOISE
VAE Decode是否接 samples 和 VAE 模型Save Image 无 IMAGE
Save Image是否接到 VAE Decode 的 IMAGE 输出图不保存

详见：ComfyUI FLUX GGUF 工作流节点都是干什么的？ 和 ComfyUI FLUX GGUF Q6_K 工作流怎么搭？

新手排查顺序

导入工作流 JSON 后的标准排查流程：

  1. 先解决红色节点（安装缺失插件 → 重启 ComfyUI）
  2. 确认模型文件目录（UNet → models/unet/，T5/CLIP → models/text_encoders/，VAE → models/vae/）
  3. 在每个节点里重新选择本地模型
  4. 分辨率先设 768x768，不要直接上 1024
  5. batch_size 固定 1
  6. steps 先用 20
  7. Queue Prompt 试跑
  8. 看控制台报错信息（不是浏览器页面，是启动 ComfyUI 的那个终端窗口）
  9. 跑通了再去 output/ 找图
  10. 最后再慢慢调参数

一次只改一个变量。

常见误区

  • 导入 JSON 就等于装好了环境——JSON 只是节点摆法，插件和模型要单独准备。
  • 红色节点 = 显存不够——红色是节点缺失，和显存无关。
  • 把 GGUF 放到 checkpoints 用 Load Checkpoint 加载——GGUF 有自己的目录和加载节点。
  • 只下了 GGUF，忘记 T5 / CLIP / VAE——四个文件缺一不可。
  • 只看浏览器界面，不看终端控制台报错——控制台的红色报错才是最准确的错误信息。
  • 导入后直接上 1024 或 1280 测试——先用 768x768 / 20 steps 确认工作流能跑通。
  • 模型放对了但没在节点里重新选——导入后每个节点的模型选择框需要手动刷新。

FAQ

Q: workflow JSON 是模型文件吗？ 不是。JSON 只是节点和连线的记录，不包含模型。模型文件（.gguf、.safetensors）需要单独下载。

Q: 为什么别人能跑，我导入就红色？ 大概率是你缺少别人工作流里用到的自定义节点。用 ComfyUI-Manager 的 Install Missing Custom Nodes 安装。

Q: 红色节点是不是 OOM？ 不是。红色节点是插件缺失或版本不匹配。OOM 是显存不够，发生在运行阶段，不是导入阶段。

Q: 模型放对了目录，为什么下拉框还是没有？ 放完文件后点 Refresh 按钮或重启 ComfyUI。如果还没有，检查文件名拼写、扩展名、目录是否正确。

Q: GGUF 能不能用 Load Checkpoint 加载？ 不能。GGUF 不是普通 checkpoint 格式。用 Unet Loader (GGUF) 加载。

Q: 导入后要不要重新选模型？ 要。别人的 JSON 里记录的是他的模型名，你需要在下拉框里重新选你本地的模型。

Q: 为什么 Queue Prompt 跑完了但没有图片？ 检查 Save Image 是否接到 VAE Decode 的 IMAGE 输出，是否直接接了 KSampler 的 LATENT。中间必须有 VAE Decode 做格式转换。

详见：ComfyUI FLUX 出图保存在哪里？

后续待测

  • 不同 ComfyUI 版本导入同一 JSON 的节点兼容性
  • ComfyUI-Manager 自动安装缺失节点的准确率
  • 不同 FLUX 工作流中节点命名的差异范围
  • JSON 分享时附带模型清单是否更可靠

相关文章