ComfyUI 常见问题与快速修复

如果你现在面对的是一个很明确的单点错误，先从这篇开始。

如果你的环境是在装完插件后反复坏掉，或者每修一个包就引出下一个问题，那就别继续随机敲命令了，直接改看更深的文档：

• 插件导入失败怎么修
• ComfyUI 启动失败怎么排查
• 依赖冲突怎么在不重装的前提下处理
• ComfyUI Reconnecting Error 的原因和修法

安装类问题

“CUDA is not available” 或 “Torch not compiled with CUDA”

原因： PyTorch 装成了不带 CUDA 的版本，或者 CUDA 版本和显卡驱动不匹配。

处理：

1. 在命令提示符里运行 nvidia-smi，确认 NVIDIA 驱动版本
2. 确认启动 ComfyUI 的那个 Python 环境里，Torch 真的是 CUDA 版：

python -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())"

3. 如果你用的是 Portable 包，确认下载的是 NVIDIA 版本，并且启动的是 run_nvidia_gpu.bat
4. 如果结果是 False，先看完整的 Torch not compiled with CUDA enabled 修复指南，不要急着继续装插件

ComfyUI Desktop 提示 “Unsupported device”

原因： Windows 上的 ComfyUI Desktop 主要要求 NVIDIA + CUDA。AMD 和 Intel GPU 在 Desktop 版本里不算稳定支持。

处理： 改用 Portable 安装 或 手动安装。

安装器或程序被杀毒软件拦截

原因： Windows Defender 或第三方安全软件把 ComfyUI 误判成可疑程序。

处理：

1. 把 ComfyUI 安装目录加入杀毒软件白名单
2. Windows Defender 路径通常是：设置 -> 隐私和安全性 -> Windows 安全中心 -> 病毒和威胁防护 -> 管理设置 -> 排除项
3. 重新下载安装包再试

7-Zip 解压失败

原因： 下载文件被 Windows 阻止，或者解压路径太深。

处理：

1. 右键 .7z 文件 -> 属性 -> 勾选 解除锁定 -> 应用
2. 尽量解压到短路径，比如 D:\ComfyUI
3. 使用 7-Zip，不要依赖 Windows 自带解压

“Permission denied” 或安装包失败

原因： 你把 ComfyUI 或安装器以管理员身份运行了，或者安装到了系统保护目录。

处理：

1. 不要以管理员身份运行 ComfyUI
2. 不要安装到 C:\Program Files、C:\Windows 或 C:\ 根目录
3. 改用普通用户可写目录，例如 D:\ComfyUI 或 C:\Users\你的用户名\ComfyUI

Windows 路径过长限制

原因： Windows 默认有 260 字符路径限制，自定义节点目录层级深时容易超限。

处理：

1. Win + R，输入 regedit
2. 打开 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
3. 把 LongPathsEnabled 设为 1
4. 重启电脑

或者以管理员身份在 PowerShell 中运行：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

运行时问题

CUDA Out of Memory

原因： 当前模型、分辨率或批量太大，显存不够。不同模型需要的显存可以先参考 系统要求。

修法，按顺序试：

1. 关掉其他占 GPU 的程序，例如浏览器、游戏、其他 AI 工具
2. 降低分辨率，例如从 1024x1024 降到 512x512
3. 在启动参数里加 --lowvram
4. 改用 GGUF 量化模型，见 下载模型
5. 跑视频模型时同时降低帧数和分辨率

如果日志里是 MemoryError、DefaultCPUAllocator、MPS backend out of memory，或者简单 --lowvram 仍然不够，就改看完整的 ComfyUI 内存不足排查。

工作流里出现红节点

原因： 工作流依赖的自定义节点你还没安装。

处理：

1. 安装 ComfyUI Manager
2. 在 Manager 中点击 Install Missing Custom Nodes
3. 重启 ComfyUI

“No checkpoint found” / 模型下拉框是空的

原因： checkpoints 目录里没有模型，或者模型放错位置。

处理：

1. 先下载模型，见 下载模型
2. 把 .safetensors 放到 ComfyUI/models/checkpoints/
3. 在模型下拉框点 Refresh，或者直接重启 ComfyUI

LoRA、VAE、ControlNet、Flux、GGUF、text encoder 等目录，请看 ComfyUI 的 safetensors 应该放哪里。

浏览器只显示空白页或只有标题

原因： 浏览器兼容性问题。

处理： 优先使用最新版 Google Chrome。较旧版本的 Edge 或 Firefox 可能渲染不完整。

如果终端里提到了 comfyui-frontend-package，继续看 ComfyUI Frontend Package。

ComfyUI 一直 reconnecting

原因： 浏览器和 ComfyUI 服务之间的长连接断了。可能是服务崩了、前端被某个节点扩展搞坏了，或者被防火墙 / 代理 / 浏览器扩展拦住了 websocket。

处理： 先看终端里的 Python 进程还在不在。再用禁用自定义节点、直接访问 http://127.0.0.1:8188 的方式验证核心服务是否正常。完整路径看 ComfyUI Reconnecting Error。

Failed to fetch server logs

原因： 浏览器界面去请求 ComfyUI 日志时失败了。常见原因是服务已经崩了、防火墙挡了请求，或者某个前端扩展把界面搞坏了。

处理： 先找真实终端日志。如果 http://127.0.0.1:8188 还能打开，就去看浏览器 DevTools，并在禁用自定义节点的情况下重测。详细见 ComfyUI Failed to Fetch Server Logs。

“Prompt has no outputs”

原因： 工作流没有输出节点，或者输出节点被静音、断开了。

处理：

1. 确保最后有 Save Image 或 Preview Image 这样的输出节点
2. 如果节点发灰，选中后按 M 取消静音
3. 如果节点发红，先用 ComfyUI Manager 安装缺失节点
4. 如果结构看起来正常但还是不跑，继续看完整的 Prompt Has No Outputs 修复指南

生成速度特别慢

原因： ComfyUI 可能跑在 CPU 上，而不是 GPU。

处理：

1. 看控制台启动日志，应该能看到你的 GPU 名称
2. Portable 包确认启动的是 run_nvidia_gpu.bat，不是 run_cpu.bat
3. 手动安装则检查：

python -c "import torch; print(torch.cuda.is_available())"

应该返回 True。如果是 False，先重装正确的 CUDA 版 PyTorch。

如果你有多张 NVIDIA 显卡，而 ComfyUI 用错了卡，去看 ComfyUI 多 GPU。

“No module named 'triton'” 或 Triton unavailable

原因： Triton 是某些加速路径的可选后端，不是所有 ComfyUI 环境都必须有。

处理： 不要在 Windows 上盲目安装普通 triton 包。只有当你的工作流或节点明确依赖 Triton 时，才按 ComfyUI No Module Named 'triton' 里的路径，用 ComfyUI 自己的 Python 去安装。

GPU 特定问题

RTX 50 系列（5070 Ti / 5080 / 5090）

完整的驱动、CUDA、PyTorch 对照关系见 GPU 兼容性。 RTX 50 系列通常需要更高版本的 CUDA 和对应的 PyTorch 包。

基础处理：

1. 先把 NVIDIA 驱动升到最新
2. 按当前官方支持矩阵安装匹配的 PyTorch CUDA 版本

pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

3. 如果你用的是 Portable 包，确保版本本身就支持对应 CUDA

50 系列常见衍生问题：

• SageAttention 编译失败：先看 ComfyUI No Module Named 'sageattention'
• Nunchaku 插件失败：看 Nunchaku Missing in ComfyUI
• xformers 崩溃：优先改用 PyTorch 自带 attention

Windows 上的 AMD GPU

完整支持情况见 GPU 兼容性。 AMD 在 Windows 上主要依赖 DirectML，有这些限制：

• 一些自定义节点不支持 DirectML
• 性能通常不如 CUDA
• 常见做法是从 portable 方案起步，再额外传 --directml

网络问题

Hugging Face 下载模型失败

原因： 可能是网络路由、代理、访问令牌、gated model 权限、离线模式或模型路径错误。

处理：

1. 先在浏览器里直接打开目标 Hugging Face URL
2. 如果浏览器能下载，但 ComfyUI 不行，就检查 ComfyUI 进程是否拿到了同样的代理配置和 HF_TOKEN
3. 复杂情况看 ComfyUI HuggingFace HttpRequestException

pip install 卡住或超时

原因： 网络限制、防火墙或代理阻断了 Python 包下载。

处理：

1. 可以先试镜像：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 如果你在代理后面：

pip install --proxy http://your-proxy:port -r requirements.txt

3. 如果你用的是 ComfyUI Desktop，则检查安装向导里的镜像设置

Git clone 失败

原因： GitHub 在你当前网络环境下被拦截或限速。

处理： 换镜像，或者直接从 GitHub release 页下载 ZIP。

Wonderful Launcher 能帮你什么

Wonderful Launcher 会把 ComfyUI 环境隔离起来，并优先做恢复，而不是一上来让你重装。 它尤其适合多插件、容易坏、又不想反复手动修环境的人。

下载 Wonderful Launcher

没找到你的问题？

去看 故障排查决策树，按顺序定位。 如果你是复杂多插件环境，再补看 依赖冲突 和 工作流环境搭建。