ComfyUIでAIワークフローを構築中に、あるノードが突然赤色に変わり、クリックすると英語のエラーメッセージが表示されるという経験をされた方へ。この記事はそんな方のために書きました。
一、なぜ赤エラーが発生するのか
ComfyUIのノードシステムはPythonスクリプトに基づいて動作しています。ノードの入力パラメータが要件を満たさない場合や依存ライブラリが欠落している場合、該当ノードは赤背景で表示され、実行が停止します。これは主に以下の状況で発生します。
第1種：モデルウェイトファイルのパスエラー（最も一般的）
インターネットでダウンロードした他人のワークフローJSONファイルを自分のComfyUIにインポートした際に、相手が使用したモデルファイルがローカルに存在しないか保存パスが異なる場合、Load Checkpointノードが赤エラーを返します。解決方法は、右側のキューパネルにある具体的なエラー情報を確認することです。通常、欠落しているファイル名が明示されています。HuggingFaceまたはCivitaiから対応する.safetensorsファイルをダウンロードし、models/checkpointsディレクトリに配置すれば問題が解消します。
第2種：カスタムノードプラグインが未インストール
他者のワークフローでComfyUI-Impact-PackやComfyUI-Managerなどのサードパーティプラグインが使用されており、ローカルにインストールされていない場合です。この場合、エラーメッセージに「ModuleNotFoundError」という文字列が含まれています。解決手順：ComfyUI Managerを開く（上部ツールバーのManagerボタンをクリック）→ 欠落ノード名を検索 → Installをクリックしてインストールします。
第3種：入力タイプの不一致
例えば、あるノードがIMAGE型の入力を必要としているのに、接続されているデータがLATENT型である場合です。ComfyUIはデータ型を自動変換しないため、エラーが発生します。解決方法は、2つのノードの間に型変換ノードを追加することです。LATENTからIMAGEへの変換にはVAE Decodeノードを使用し、その逆にはVAE Encodeノードを使用します。
二、高頻度エラー一覧と修正方法
"No module named 'xxx'"
Pythonの依存ライブラリが不足しています。ComfyUIのルートディレクトリでコマンドラインを開き、pip install xxx を実行して欠落パッケージをインストールします。具体的な名称が不明な場合は、エラーメッセージ内のモジュール名をそのままコピーしてください。
"CUDA out of memory"
VRAM不足です。解決方法：解像度を下げる（1024x1024から512x512への変更など）。ComfyUIの起動パラメータに--lowvramモードを追加する。または、GPUを使用している他のプログラムを終了する。
"Checkpoint file not found"
モデルファイルが欠落しているか、パスの設定に誤りがあります。models/checkpointsディレクトリに、エラーで示されたファイル名が存在するか確認してください。大文字と小文字が完全に一致している必要があります。
"Invalid image size: must be multiple of 64"
解像度が64の倍数ではありません。幅と高さを800x1200や512x768などの標準的なサイズに調整してください。
三、エラー防止のためのベストプラクティス
第一に、他人のワークフローをインポートする前に、現在のプロジェクトをバックアップする（File → Save Workflow）。第二に、新しいノードプラグインをインストールした後は、必ずComfyUIサービスを再起動する。第三に、ComfyUIコアプログラムとすべてのカスタムノードを定期的に最新バージョンに更新する。多くのエラーは、旧バージョンのプラグインと新バージョンのコアプログラムの非互換性が原因で発生します。
