ComfyUI 避坑指南：新手最常犯的 10 个错误，每一条都是血泪教训

ComfyUI 避坑指南：新手最常犯的 10 个错误，每一条都是血泪教训

ComfyUI 上手门槛高，新手容易在很多地方卡住。这篇文章把最常见的 10 个坑列出来，每个都有具体的解决方法。

---

坑 1：模型放错目录

现象：下载了模型但 ComfyUI 列表里找不到，或者报 model not found。

ComfyUI 目录结构：

ComfyUI/
├── models/
│   ├── checkpoints/    ← 主模型（.safetensors/.ckpt）放这里
│   ├── vae/            ← VAE 模型放这里
│   ├── loras/          ← LoRA 模型放这里
│   ├── controlnet/     ← ControlNet 模型放这里
│   ├── clip/           ← CLIP 模型放这里
│   ├── upscale_models/ ← 超分模型放这里
│   └── embeddings/     ← Textual Inversion 放这里

放错了位置就是找不到，注意区分各类模型的目录。

---

坑 2：SDXL 模型配 SD1.5 的 LoRA

现象：加载 LoRA 后图像完全变形，或者报错。

原因：SDXL 和 SD1.5 的模型架构完全不同，LoRA 不能混用。

判断方法：

下载模型时注意文件名：
• sd_xl_base_1.0.safetensors → SDXL 模型
• v1-5-pruned.safetensors → SD1.5 模型

LoRA 文件也有对应版本：
• xxxxLoRA-SDXL.safetensors → 只能配 SDXL
• xxxxLoRA-SD15.safetensors → 只能配 SD1.5

---

坑 3：不装 ComfyUI Manager 就开始折腾节点

现象：手动 git clone 节点，依赖安装失败，版本冲突。

正确做法：第一步就安装 ComfyUI Manager：

cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
# 重启 ComfyUI

之后所有节点通过 Manager 安装，自动处理依赖，省心 90%。

---

坑 4：直接运行网上找的工作流 JSON，各种报红

现象：导入工作流后满屏红色节点，无法运行。

原因：工作流依赖特定的自定义节点，你的环境没有安装。

解决步骤：

1. Manager → Install Missing Custom Nodes（自动检测并安装缺失节点）
2. 重启 ComfyUI
3. 重新加载工作流
4. 如果还有红色节点，查看节点名称，在 Manager 搜索并安装

---

坑 5：生成分辨率和模型不匹配

现象：生成的图像中有多余的人物、奇怪的肢体、画面分裂感。

原因：模型有推荐的训练分辨率，偏差太大会出问题。

推荐分辨率：

模型	推荐分辨率	最大分辨率
SD 1.5	512x512	768x768
SD 2.1	768x768	1024x1024
SDXL	1024x1024	1536x1536
Flux.1	1024x1024	2048x2048

要生成更大分辨率：先按推荐分辨率生成，再用超分节点（Upscale）放大，而不是直接设置超大分辨率。

---

坑 6：VAE 选错导致图像发灰或颜色异常

现象：生成的图像颜色发灰、对比度低、整体暗淡。

原因：SDXL 模型需要配套的 SDXL VAE，不能用 SD1.5 的 VAE。

# 下载正确的 SDXL VAE
# 文件：sdxl_vae.safetensors
# 放在：models/vae/

# 在工作流的 VAE Loader 节点选择正确的 VAE

部分 SDXL 模型（如 JuggernautXL）已内置 VAE，不需要单独加载。

---

坑 7：CFG 值设太高或太低

现象：CFG 太高 → 图像过于饱和、锐利，甚至变形；CFG 太低 → 图像模糊，不符合提示词。

推荐值：

模型	推荐 CFG	说明
SD 1.5	7-8	经典默认值
SDXL	5-7	SDXL 对 CFG 更敏感
Flux.1	1-3.5	Flux 使用引导蒸馏，CFG 要低

特别注意：Flux.1 模型用传统 CFG 值（7）会严重过曝，这是新手最常踩的坑之一。

---

坑 8：频繁更新节点破坏已有工作流

现象：ComfyUI Manager 更新了某个节点后，之前好用的工作流报错了。

原因：节点 API 变更，旧工作流的节点参数不兼容新版本。

最佳实践：

# 生产环境：锁定节点版本，不随意更新
# 在 ComfyUI Manager 中：
# Manager → Update All → 不要在生产机操作

# 建立测试环境
# 先在测试机更新，验证工作流正常后再更新生产机

# 备份工作正常的节点
cd custom_nodes
tar -czf working_nodes_backup.tar.gz .

---

坑 9：生成图像后不知道文件在哪

现象：生成成功但找不到图片文件。

图片默认保存位置：

# 图片保存在 ComfyUI/output 目录
ls ComfyUI/output/
# 按日期分文件夹：ComfyUI_00001_.png, ComfyUI_00002_.png

如果在 Web 界面，点击生成的图片右键可以直接保存。

也可以修改保存路径：在 Save Image 节点中设置 filename_prefix。

---

坑 10：服务器直接对外暴露，没有任何防护

风险：ComfyUI 没有内置认证，直接开放 8188 端口等于完全公开，GPU 算力会被滥用。

# 最简保护：Nginx Basic Auth
sudo htpasswd -c /etc/nginx/.htpasswd your-username

# Nginx 配置
location / {
    auth_basic "ComfyUI";
    auth_basic_user_file /etc/nginx/.htpasswd;
    proxy_pass http://127.0.0.1:8188;
}

# 或者：只允许内网 IP 访问
allow 192.168.1.0/24;
deny all;

---

总结

ComfyUI 的这些坑大多数来自两个方向：模型版本不匹配和节点管理不规范。记住这两条原则，能避免 80% 的问题。

如果你需要一个稳定可靠的 ComfyUI 服务环境，LocalClaw（insman.cn） 上的专业服务商可以提供包含安全配置和版本管理的完整部署服务。