ComfyUI 常见问题与快速修复

如果你搜索了 ComfyUI common issues、ComfyUI problems、ComfyUI not working 或 broken ComfyUI，请从这里开始。本页是 ComfyUI 常见故障的导航页，并非每条错误追踪的最终解答。

如果安装插件后环境持续崩溃，或"修复"某个包后启动依然反复失败，请切换到更深入的指南，而不是重复随机命令行修复：

• 如何修复 ComfyUI 插件导入失败错误
• ComfyUI 启动失败？如何更快诊断和恢复
• ComfyUI 依赖冲突：无需重装即可修复
• ComfyUI 重连错误：原因与快速修复

先找对修复方案

安装问题

"CUDA is not available" 或 "Torch not compiled with CUDA"

原因： PyTorch 安装时未包含 CUDA 支持，或 CUDA 版本与你的 NVIDIA 驱动不匹配。

修复方法：

1. 检查你的 NVIDIA 驱动版本：在命令提示符中运行 nvidia-smi
2. 确认启动 ComfyUI 的 Python 使用的是支持 CUDA 的 Torch 构建版本：

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

3. 如果你使用的是便携版，请确保下载的是 NVIDIA 版本，并运行 run_nvidia_gpu.bat
4. 如果输出 False，请先按照完整的 Torch not compiled with CUDA enabled 修复指南 操作，再安装更多插件

ComfyUI Desktop 显示"不支持的设备"

原因： Windows 上的 ComfyUI Desktop 需要支持 CUDA 的 NVIDIA GPU，不支持 AMD 和 Intel GPU。

修复方法： 改用 便携版 或 手动安装版。

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

原因： Windows Defender 或第三方杀毒软件将 ComfyUI 标记为可疑程序。

修复方法：

1. 将 ComfyUI 的安装目录添加到杀毒软件的例外列表
2. 对于 Windows Defender：设置 → 隐私和安全性 → 病毒和威胁防护 → 管理设置 → 排除项
3. 重新下载后再试

7-Zip 解压失败

原因： 下载的文件被 Windows 拦截，或路径过长。

修复方法：

1. 右键点击 .7z 文件 → 属性 → 勾选解除锁定 → 应用
2. 解压到短路径，例如 D:\ComfyUI，而非深层嵌套的文件夹
3. 确保使用的是 7-Zip，而非 Windows 内置的压缩工具

"Permission denied" 或包安装失败

原因： 以管理员身份运行 ComfyUI 或其安装程序，或安装到系统保护目录。

修复方法：

1. 切勿以管理员身份运行 ComfyUI — 这会导致 Python 包权限冲突
2. 不要安装到 C:\Program Files、C:\Windows 或 C:\ 根目录
3. 使用非系统路径，例如 D:\ComfyUI 或 C:\Users\YourName\ComfyUI

Windows 长路径限制

原因： Windows 默认路径长度限制为 260 个字符，自定义节点的深层目录结构可能超出此限制。

修复方法： 在 Windows 10/11 中启用长路径：

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 显存不足

原因： 你的 GPU 显存不足以支持当前使用的模型或分辨率。各模型类型的显存需求请参见 系统要求。

修复方法（按顺序尝试）：

1. 关闭其他占用 GPU 的应用（浏览器、游戏、其他 AI 工具）
2. 降低图像分辨率（例如使用 512×512 而非 1024×1024）
3. 在启动命令中添加 --lowvram 标志
4. 使用 GGUF 量化模型（参见 下载模型）
5. 对于视频模型：减少帧数和分辨率

如果日志显示 MemoryError、DefaultCPUAllocator、MPS backend out of memory，或基本的 --lowvram 修改后机器仍然失败，请使用完整的 ComfyUI 内存不足指南 来区分显存、系统内存和分配器问题。

工作流中出现红色节点

原因： 工作流使用了你尚未安装的自定义节点。

修复方法：

1. 安装 ComfyUI Manager
2. 在 Manager 中点击安装缺失的自定义节点
3. 重启 ComfyUI

"No checkpoint found" / 模型下拉列表为空

原因： checkpoints 文件夹中没有模型文件，或文件放置位置不正确。

修复方法：

1. 下载一个模型（参见 下载模型）
2. 将 .safetensors 文件放入 ComfyUI/models/checkpoints/
3. 点击模型下拉列表中的刷新，或重启 ComfyUI

关于 LoRA、VAE、ControlNet、Flux、GGUF 和文本编码器的文件夹位置，请参见 ComfyUI 中 Safetensors 文件应放在哪里。

浏览器显示空白页或仅显示标题

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

修复方法： 使用最新版本的 Google Chrome。部分浏览器（尤其是旧版 Edge 或 Firefox）可能无法正确渲染 ComfyUI 界面。

如果终端提示 comfyui-frontend-package，请参见 ComfyUI 前端包。

ComfyUI 持续重连

原因： 浏览器与 ComfyUI 服务器的实时连接中断。可能是服务器崩溃、自定义节点破坏了前端，或防火墙/代理/浏览器扩展阻断了 WebSocket 连接。

修复方法： 首先检查终端是否仍在运行。然后在禁用自定义节点的情况下测试，并通过 http://127.0.0.1:8188 打开 ComfyUI，再测试局域网或代理访问。完整诊断流程请参见 ComfyUI 重连错误。

无法获取服务器日志

原因： 浏览器界面尝试从 ComfyUI 服务器读取日志，但请求失败。可能发生在服务器崩溃、防火墙拦截请求，或自定义节点/前端扩展破坏了部分 UI 时。

修复方法： 首先查找真实的终端日志。如果服务器仍在 http://127.0.0.1:8188 响应，请检查浏览器开发者工具，并在禁用自定义节点的情况下测试。参见 ComfyUI 无法获取服务器日志。

"Prompt has no outputs"

原因： 工作流中没有输出节点（如保存图像、预览图像等），或输出节点被静音或断开连接。

修复方法：

1. 确保节点链末尾连接了保存图像或预览图像节点
2. 如果节点显示为灰色，请选中它们并按 M 键取消静音
3. 如果节点为红色（缺少自定义节点），请通过 ComfyUI Manager → 安装缺失的自定义节点 进行安装
4. 如果工作流看起来正确但队列拒绝运行，请使用完整的 ComfyUI 提示词无输出修复指南 检查静音分支、断开的输出链以及含有缺失节点的导入工作流

生成速度极慢

原因： ComfyUI 可能正在使用 CPU 而非 GPU 运行。

修复方法：

1. 检查控制台输出 — 启动时应显示你的 GPU 名称
2. 如果使用便携版：确保运行的是 run_nvidia_gpu.bat，而非 run_cpu.bat
3. 如果使用手动安装：验证 PyTorch 是否支持 CUDA：

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

应输出 True。如果输出 False，请使用启动 ComfyUI 的同一个 Python，按 Torch Missing 选择匹配的 CUDA wheel。

如果你有多块 NVIDIA GPU 且 ComfyUI 使用了错误的显卡，请参见 ComfyUI 多 GPU 了解 --cuda-device、独立端口和双实例配置。

"No module named 'triton'" 或 Triton 不可用

原因： Triton 是 SageAttention、torch.compile 和部分自定义节点的可选加速后端。如果 ComfyUI 可以正常打开且普通工作流可以运行，这通常不是根本问题。

修复方法： 不要在 Windows 上盲目安装普通的 triton 包。如果工作流确实需要 Triton，请使用 ComfyUI 专属的 Python，并按照 ComfyUI No Module Named 'triton' 中的 Windows 包路径安装。对于便携版构建，通常应使用 python_embeded\python.exe，而非系统 Python。

GPU 特定问题

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

完整的驱动-CUDA-PyTorch 矩阵请参见 GPU 兼容性。RTX 50 系列需要 CUDA 12.8+ 和特定的 PyTorch 构建版本：

1. 将你的 NVIDIA 驱动更新到最新版本
2. 在启动 ComfyUI 的 Python 中，按 PyTorch 官方安装选择器安装匹配的 PyTorch。CUDA wheel 命令模式是：

python -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

将 cuXXX 替换为你的 PyTorch build 支持的 CUDA wheel 标签。不要把它当成通用复制命令，也不要在主命令里加入第三方镜像。 3. 对于便携版，请使用包含所需 CUDA 支持的最新发布版本

50 系列常见问题：

• SageAttention 编译错误 — 在添加加速包之前请先参见 ComfyUI No Module Named 'sageattention'
• Nunchaku 插件失败 — 使用 Nunchaku Missing in ComfyUI 指南，选择与 Python、Torch、CUDA 和 GPU 匹配的官方 wheel
• xformers 崩溃 — 使用 PyTorch 内置的注意力机制（--use-pytorch-cross-attention）

Windows 上的 AMD GPU

完整的 AMD 支持详情请参见 GPU 兼容性。Windows 上的 AMD 支持使用 DirectML，存在以下限制：

• 部分自定义节点不支持 DirectML
• 性能低于 CUDA
• 需要在真实启动命令中传入 --directml，不要把 GPU 参数加到 run_cpu.bat

网络问题

Hugging Face 模型下载失败

原因： ComfyUI、自定义节点或启动器无法从 Hugging Face 下载模型文件。根本原因可能是网络路由、代理设置、受限模型访问权限、无效令牌、离线模式或错误的模型路径。

修复方法： 首先在浏览器和终端中测试确切的 Hugging Face URL。如果浏览器正常但 ComfyUI 失败，请检查 ComfyUI 进程是否具有相同的代理和 HF_TOKEN 环境变量。完整诊断流程请参见 ComfyUI HuggingFace HttpRequestException。

pip install 挂起或超时

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

修复方法：

1. 如果使用代理，请配置 pip：

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

2. 在 ComfyUI Desktop 中：在设置向导里更改镜像设置
3. 如果你的组织要求区域镜像，请使用其正式文档和可信端点；不要把不熟悉的镜像盲目加进修复命令

Git clone 失败

原因： GitHub 在你所在地区被封锁或受到速率限制。

修复方法： 使用镜像，或直接从 GitHub 发布页面下载 ZIP 文件。

Wonderful Launcher 如何提供帮助

Wonderful Launcher 可以自动检测并修复此问题。它能安全地管理你的 ComfyUI 环境——隔离依赖、恢复损坏的安装并防止冲突。

下载 Wonderful Launcher — 完全免费。

没有找到你的问题？

请尝试 故障排除决策树 进行系统性诊断。对于复杂的多插件环境，请参见 依赖冲突 和 工作流环境配置。

仍然卡住了？

如果以上方案都无效，请尝试 Wonderful Launcher 在无需重新安装的情况下恢复你的环境。

参考资料

• ComfyUI 故障排除概览
• ComfyUI 自定义节点故障排除指南
• ComfyUI 系统要求