故障排除
常见问题
ComfyUI 安装和运行中最常见问题的解决方案。
安装问题
"CUDA is not available" 或 "Torch not compiled with CUDA"
原因: 安装的 PyTorch 不包含 CUDA 支持,或 CUDA 版本与 NVIDIA 驱动不匹配。
解决方法:
- 检查你的 NVIDIA 驱动版本:在命令提示符中运行
nvidia-smi - 重新安装正确 CUDA 版本的 PyTorch:
pip uninstall torch torchvision torchaudio
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu126
- 如果你使用的是便携包,确保下载的是 NVIDIA 版本并且运行的是
run_nvidia_gpu.bat
ComfyUI Desktop 显示 "Unsupported device"
原因: Windows 上的 ComfyUI Desktop 需要支持 CUDA 的 NVIDIA GPU。Desktop 版本不支持 AMD 和 Intel GPU。
安装程序或应用被杀毒软件拦截
原因: Windows Defender 或第三方杀毒软件将 ComfyUI 标记为可疑程序。
解决方法:
- 将 ComfyUI 的安装目录添加到杀毒软件的排除列表中
- 对于 Windows Defender:设置 → 隐私和安全性 → 病毒和威胁防护 → 管理设置 → 排除项
- 重新下载并再次尝试
7-Zip 解压失败
原因: 下载的文件被 Windows 锁定,或路径过长。
解决方法:
- 右键点击
.7z文件 → 属性 → 勾选 解除锁定 → 应用 - 解压到较短的路径,例如
D:\ComfyUI,而非深层嵌套的文件夹 - 确保你使用的是 7-Zip,而非 Windows 内置的解压工具
"Permission denied" 或包安装失败
原因: 以管理员身份运行 ComfyUI 或其安装程序,或安装到系统保护的文件夹。
解决方法:
- 永远不要以管理员身份运行 ComfyUI — 这会导致 Python 包权限冲突
- 不要安装到
C:\Program Files、C:\Windows或C:\根目录 - 使用非系统路径,如
D:\ComfyUI或C:\Users\你的用户名\ComfyUI
Windows 长路径限制
原因: Windows 默认有 260 个字符的路径长度限制。自定义节点中的深层文件夹结构可能超出此限制。
解决方法: 在 Windows 10/11 中启用长路径:
- 按
Win + R,输入regedit,按回车 - 导航到
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem - 将
LongPathsEnabled设置为1 - 重启计算机
或在 PowerShell 中运行(以管理员身份):
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
运行时问题
CUDA 显存不足
原因: 你的 GPU 没有足够的 VRAM 来运行当前使用的模型或分辨率。参见系统要求获取各模型类型的 VRAM 指导。
解决方法(按顺序尝试):
- 关闭其他使用 GPU 的应用程序(浏览器、游戏、其他 AI 工具)
- 降低图像分辨率(例如使用 512×512 替代 1024×1024)
- 在启动命令中添加
--lowvram参数 - 使用 GGUF 量化模型(参见下载模型)
- 对于视频模型:减少帧数和分辨率
工作流中出现红色节点
原因: 工作流使用了你尚未安装的自定义节点。
解决方法:
- 安装 ComfyUI Manager
- 在 Manager 中点击 Install Missing Custom Nodes
- 重启 ComfyUI
"No checkpoint found" / 模型下拉菜单为空
原因: checkpoints 文件夹中没有模型文件,或文件放在了错误的位置。
解决方法:
- 下载一个模型(参见下载模型)
- 将
.safetensors文件放入ComfyUI/models/checkpoints/ - 点击模型下拉菜单中的 Refresh,或重启 ComfyUI
浏览器显示空白页面或只有标题
原因: 浏览器兼容性问题。
解决方法: 使用最新版本的 Google Chrome。某些浏览器(特别是较旧版本的 Edge 或 Firefox)可能无法正确渲染 ComfyUI 界面。
生成速度极慢
原因: ComfyUI 可能在使用 CPU 而非 GPU 运行。
解决方法:
- 检查控制台输出 — 启动时应该显示你的 GPU 名称
- 如果使用便携包:确保你运行的是
run_nvidia_gpu.bat,而不是run_cpu.bat - 如果使用手动安装:验证 PyTorch 是否支持 CUDA:
python -c "import torch; print(torch.cuda.is_available())"
应该输出 True。如果输出 False,请重新安装带 CUDA 支持的 PyTorch。
GPU 相关问题
RTX 50 系列(5070 Ti / 5080 / 5090)
参见 GPU 兼容性获取完整的驱动-CUDA-PyTorch 对照表。RTX 50 系列需要 CUDA 12.8+ 和特定的 PyTorch 构建:
- 将 NVIDIA 驱动更新到最新版本
- 安装 CUDA 13.0 版本的 PyTorch:
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
- 对于便携包,使用支持 CUDA 13.0 的最新版本
常见的 50 系列问题:
- SageAttention 编译错误 — 需要更新的构建工具
- Nunchaku 插件故障 — 检查是否有兼容 50 系列的版本
xformers崩溃 — 使用 PyTorch 内置的 attention(--use-pytorch-cross-attention)
Windows 上的 AMD GPU
参见 GPU 兼容性获取完整的 AMD 支持详情。Windows 上的 AMD 支持使用 DirectML,存在一些限制:
- 部分自定义节点不支持 DirectML
- 性能低于 CUDA
- 使用便携包的
run_cpu.bat并添加--directml参数
网络问题
pip install 卡住或超时
原因: 网络限制、防火墙或代理阻止了 Python 包下载。
解决方法:
- 尝试使用镜像源:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
- 如果在代理后面,配置 pip:
pip install --proxy http://your-proxy:port -r requirements.txt
- 在 ComfyUI Desktop 中:在设置向导中更改镜像设置
Git clone 失败
原因: GitHub 在你所在的地区被屏蔽或限速。
解决方法: 使用镜像或直接从 GitHub 发布页面下载 ZIP 文件。
没有找到你的问题?
尝试故障排除决策树进行系统性诊断。对于复杂的多插件环境,参见依赖冲突和工作流环境配置。
仍然无法解决?
如果以上方案都无法解决你的问题,你可以预约远程修复服务。我们通过屏幕共享连接并诊断你的具体配置 — 大多数问题在 30 分钟内即可解决。
Wonderful Launcher 文档