トラブルシューティング

ログ内のキーワード: Required input is missing

バックエンドが実行前に必須入力の不足を検出しました。報告されたノードと入力欄を使って該当箇所を修正してから、ほかのエラーを調べます。

ログ内のキーワード: has no class_type

API 実行ノードには class_type が必要です。同じ missing_node_type カテゴリでは、リクエストにクラスが含まれていてもバックエンドが認識しないケースが報告されることがあります。message と extra_info を併せて確認してください。

ログ内のキーワード: prompt_outputs_failed_validation

拒否されたリクエストは、構造化されたエラー情報を調べる必要があります。HTTP 400 だけではネットワークが不安定だとは判断できず、延々と再送信するべきではありません。

ログ内のキーワード: execution_cached

すぐに完了した場合、キャッシュされた実行、プレビュー専用のエンドポイント、一時ストレージ、クライアントによるイベントの誤認が関係している可能性があります。生成に失敗したとは限りません。

ログ内のキーワード: Failed to fetch dynamically imported module

Python サーバーは動作中でも、キャンバスが表示されないことがあります。関係のないモデルを再インストールする前に、静的アセット、JavaScript 拡張機能、バックエンドが利用できない状態を区別します。

ログ内のキーワード: Connection refused

localhost は、リクエストを行うデバイスを指します。ブラウザー、スマートフォン、コンテナー、ノートブック、リモートサーバーでは、その意味が異なります。

ログ内のキーワード: Value not in list

保存済みの ckpt_name、lora_name などの値が、現在選べる一覧にありません。まずエラーに示された入力欄を確認します。サンプラーなど、ファイル以外の選択肢でも起こり得ます。

ログ内のキーワード: VAEDecode

サンプリングが完了しても、潜在画像をピクセルにデコードする処理が残っています。そのため、サンプリング開始時のメモリ不足とは分けて考える必要があります。

ログ内のキーワード: CUDA out of memory

負荷を下げる前に、GPU メモリの確保に失敗した段階を特定します。GPU の公称 VRAM 容量、モデルファイルの大きさ、その処理で実際に使用できるメモリは異なります。

ログ内のキーワード: torch.cuda.is_available() = False

NVIDIA GPU を使う想定でも、False が示すのはこのプロセスが CUDA を使えないということだけです。完全な診断とみなさず、ビルド、デバイスの可視性、ドライバーを確認します。

ログ内のキーワード: Torch not compiled with CUDA enabled

このエラーは CPU 専用の Torch ビルドがインストールされたことを示す場合があります。一方で、選択したビルドやバックエンドでは CUDA を提供できないのに、ノードが CUDA を呼び出している場合にも発生します。

ログ内のキーワード: _ARRAY_API not found

これらのメッセージは通常、ワークフローの接続不良ではなく、NumPy とコンパイル済み拡張機能とのインターフェースに関係します。NumPy を変更する前に、最初に関係する拡張機能を特定します。

ログ内のキーワード: ImportError: cannot import name

モジュールが存在していても、必要なクラスや関数がなくなっていることがあります。不完全な更新、API の変更、ローカルの名前衝突は、パッケージが見つからないように見える場合がありますが、対処方法は異なります。

ログ内のキーワード: ModuleNotFoundError

ターミナルでのインストール成功だけでは、ComfyUI が同じ Python を使っているとは分かりません。読み込み名、配布パッケージ名、実行中の Python を分けて確認します。

ログ内のキーワード: Missing Node Types

読み込んだワークフローに未解決のノードがあるときは、まずワークフローのコピーと入手元を保存します。ノードの不足表示だけで、そのファイルがコンピューター上にないとは判断できません。

ログ内のキーワード: xFormers can't load C++/CUDA extensions

pip では xFormers がインストール済みと表示されても、C++/CUDA 拡張の読み込みに失敗したり、入力に対応する アテンション演算子がなかったりすることがあります。パッケージの存在と、使用可能な GPU カーネルは別々に確認します。

ログ内のキーワード: Failed to save workflow

下書きの保存、ファイルのダウンロード、API 形式との混同を調べる前に、エクスポートを保全します。

ログ内のキーワード: No workflow found

表示された結果、スクリーンショット、再保存した画像には、復元可能なワークフローデータが含まれていない場合があります。それだけで読み込み機能の故障を示すわけではありません。

ログ内のキーワード: Dependency cycle detected

通常のデータ依存ループが有効な実行順序を妨げます。これは、明示的に定義された動作を持つ、サポート対象のループ／制御フローノードとは異なります。

ログ内のキーワード: The paging file is too small for this operation to complete

この Windows エラーは、コミット済みシステムメモリに関するものです。モデル読み込み中に表示されたというだけで、VRAM の枯渇や safetensors ファイルの破損を示すものとして扱わないでください。

ログ内のキーワード: File name too long

展開、Git チェックアウト、ノードのビルドは、長いパスが原因で失敗する場合があります。システム設定を変更したり、既存の Python 環境を移動したりする前に、失敗したツールを特定してください。

ログ内のキーワード: DLL load failed

名前が示された Python モジュールは、不足しているか互換性のない別のランタイムライブラリに依存している場合があります。ネイティブ読み込みの失敗は、最上位の Python パッケージが単に存在しない場合とは異なります。

ログ内のキーワード: execution_error

ソケットが接続し、キュー要求が受け付けられても、それだけでは結果が返ったことにはなりません。client_id、prompt_id、終了イベント、履歴を合わせて確認します。

ログ内のキーワード: No module named 'webcolors'

カラー系ノードの AttributeError は、モジュール不足ではなく古いマッピングに関する問題かもしれません。パッケージを修復する前に例外の種類を確認します。