如果你在用ComfyUI搭建AI工作流時遇到過某個節點突然變紅、點擊後彈出一串英文錯誤訊息的情況——這篇文章就是為你準備的。
一、為什麼會出現紅色報錯
ComfyUI的節點系統基於Python腳本運行。當某個節點的輸入參數不符合要求或依賴套件缺失時，該節點會顯示為紅色背景並停止執行。這通常發生在以下幾種情境：
第一種：模型權重檔案路徑錯誤（最常見）
當你從網路上下載別人的工作流JSON檔案匯入自己的ComfyUI時，如果對方使用的模型檔案在你本機不存在或存放路徑不同，Load Checkpoint節點就會報紅色錯誤。解決方法是檢查右側佇列面板中的具體報錯資訊——通常會明確告訴你缺少哪個檔案名稱。前往HuggingFace或Civitai下載對應的.safetensors檔案後放入models/checkpoints目錄即可。
第二種：自訂節點外掛未安裝
別人的工作流中用到了ComfyUI-Impact-Pack或ComfyUI-Manager等第三方外掛，而你本機沒有安裝。這種情況下報錯資訊會包含"ModuleNotFoundError"字樣。解決步驟：開啟ComfyUI Manager（點擊頂部工具列的Manager按鈕）→ 搜尋缺失的節點名稱 → 點擊Install安裝。
第三種：輸入類型不相符
例如某個節點需要IMAGE類型的輸入，但你連入的是LATENT類型的資料。ComfyUI不會自動轉換資料類型，所以會報錯。解決方法是在兩個節點之間加入類型轉換節點——從LATENT轉IMAGE需要用VAE Decode節點，反之用VAE Encode節點。
二、高頻報錯清單及修復方法
"No module named 'xxx'"
缺少Python依賴套件。在ComfyUI根目錄開啟命令列，執行 pip install xxx 安裝缺少的套件。如果不確定具體名稱，先完整複製錯誤訊息中的模組名稱。
"CUDA out of memory"
顯示記憶體不足。解決方法：降低解析度（如從1024×1024改為512×512）；在ComfyUI啟動參數中加入 --lowvram 模式；或者關閉其他佔用GPU的程式。
"Checkpoint file not found"
模型檔案缺失或路徑設定錯誤。檢查 models/checkpoints 目錄下是否存在報錯中提到的檔案名稱，注意大小寫必須完全一致。
"Invalid image size: must be multiple of 64"
解析度不是64的整數倍。將寬度和高度調整為800×1200或512×768等標準尺寸即可。
三、預防報錯的最佳實踐
匯入他人工作流前先備份自己的目前專案（File → Save Workflow）；第二，安裝新節點外掛後務必重新啟動ComfyUI服務；第三，定期更新ComfyUI核心程式和所有自訂節點到最新版本——很多報錯是因為舊版外掛與新版核心程式不相容所導致的。
