目录
ComfyUI 常见问题与故障排除
显存不足：CUDA out of memory / allocation failed
按顺序尝试：
- 降低分辨率或
batch_size。 - 使用 FP8 或 GGUF 量化版本的模型。
- 大图的 VAE 解码改用 VAE Decode (Tiled)。
- 关闭其他占用显存的程序（浏览器、游戏、其他 AI 工具）。
- 启动时添加
--lowvram。 - 点击界面上的“释放显存 / Unload models”（位置因版本而异），或重启 ComfyUI。
节点出现红框
运行时会显示错误信息，说明具体是哪个节点、哪个输入有问题：
| 消息内容 | 原因 |
|---|---|
| Required input is missing | 必需的输入没有连接 |
| Value not in list | 所选模型文件不存在（例如加载别人的工作流，但你没有那个模型）。重新选择或下载该模型 |
| 节点标题显示红色、无法识别 | 缺少自定义节点，使用 Manager 的 Install Missing Custom Nodes |
找不到刚下载的模型
- 确认模型放在正确的文件夹中（见 模型下载与文件夹）。
- 按
R刷新，或重启 ComfyUI。 - 确认文件已完整下载（对比文件大小）。
生成的图片全黑
- VAE 精度问题：尝试使用模型专用的 VAE，或改用其他 VAE。
- 使用了不兼容的组合（例如模型与 VAE 属于不同系列）。
- 某些显卡在特定精度设置下会生成黑图，可以查看终端中的警告信息。
图片质量很差、画面异常
| 现象 | 检查项 |
|---|---|
| 模糊、细节少 | steps 太少；分辨率太低 |
| 过度饱和、图像损坏 | CFG 太高；LoRA 强度太高 |
| 人物重复、构图奇怪 | 分辨率远高于模型建议值，改用先生成再放大的方式 |
| 完全不像提示词 | CFG 太低；LoRA / ControlNet 与模型版本不匹配 |
| 手指过多、脸部崩坏 | 模型限制；使用局部重绘修正 |
生成很慢
- 在终端的启动信息中确认使用的是 GPU（
Device: cuda:0 ...）。 - 如果终端显示
loaded partially之类的信息，表示模型无法全部装入显存，部分内容位于系统内存中；换用更小的模型版本。 - 首次运行需要加载模型，之后会快一些。
Torch not compiled with CUDA enabled
安装的是 CPU 版 PyTorch。在 ComfyUI 的 Python 环境中重新安装 GPU 版本：
pip uninstall torch torchvision torchaudio
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130（CUDA 版本号以 ComfyUI README 的建议为准。）
更新后无法启动
多数情况下是某个自定义节点与新版不兼容：
- 查看终端中的错误信息，找出出错的节点名称。
- 暂时将该节点从
custom_nodes文件夹中移出，然后启动。 - 更新该节点，或前往它的 GitHub 页面查看是否已有修复。
中文路径或文件名导致的问题
模型、图片或安装路径中包含中文或特殊字符时，部分自定义节点可能会出错。安装路径尽量使用英文且不含空格。
将图片拖入工作流后没有反应
图片中的工作流信息已被移除（例如经过社交平台或即时通讯软件压缩）。请获取原始 PNG 或 JSON 文件。
局域网中的其他电脑无法连接
启动时添加 --listen（例如 --listen 0.0.0.0），并确认防火墙允许 8188 端口。ComfyUI 没有账号密码保护，只应在可信的网络中开放。
哪里可以找到更多工作流？
- ComfyUI 内置的模板
- 模型的官方页面（通常会附带示例工作流）
- 社区网站分享的工作流（注意确认所需的自定义节点是否可信）
更新于 2026年10月12日