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，先用啟動 ComfyUI 的同一個 Python，按 Torch Missing 選擇匹配的 CUDA wheel。

如果你有多張 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. 在啟動 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. 如果你用的是 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 --proxy http://your-proxy:port -r requirements.txt

2. 在 ComfyUI Desktop 中：在 setup wizard 裡更改 mirror 設定

3. 如果你的組織要求區域鏡像，請使用其正式文檔和可信端點；不要把不熟悉的鏡像盲目加進修復命令

4. 如果你用的是 ComfyUI Desktop，則檢查安裝嚮導裡的鏡像設置

Git clone 失敗

原因： GitHub 在你當前網絡環境下被攔截或限速。

處理： 換鏡像，或者直接從 GitHub release 頁下載 ZIP。

Wonderful Launcher 能幫你什麼

Wonderful Launcher 會把 ComfyUI 環境隔離起來，並優先做恢復，而不是一上來讓你重裝。 它尤其適合多插件、容易壞、又不想反覆手動修環境的人。

下載 Wonderful Launcher

沒找到你的問題？

去看 故障排查決策樹，按順序定位。 如果你是複雜多插件環境，再補看 依賴衝突 和 工作流環境搭建。