トラブルシューティング

ログ内のキーワード: expected input

想定外のチャンネル数や潜在画像の次元がある場合は、モデル、VAE、潜在画像を構築するノードをまとめて確認します。画像と動画の潜在画像がすべて同じ構造とは限りません。

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

Torch を変更する前に、基本パッケージの不足とオプション機能の依存関係を区別します。

ログ内のキーワード: IPAdapter model not found.

ダウンロードした IPAdapter ファイルがディスク上に存在していても、統合ローダーのプリセット照合条件を満たすとは限りません。ファイル名を変えたり移動したりする前に、使用中のローダーを特定します。

ログ内のキーワード: Windows protected your PC

まず、どのセキュリティ機能がどのファイルをブロックしたのかを確認します。見慣れたファイル名でも、ダウンロードしたものが発行元のオリジナルリリースだとは証明できません。

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

insightface の不足、wheel のビルド失敗、初期化エラーでは、それぞれ別の確認が必要です。インタープリター、ネイティブビルド、実行バックエンド、モデルファイルを調べます。

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

Hydra の一般的な配布パッケージ名は、インポート名と異なります。モジュール不足と設定不足には、それぞれ別の修復が必要です。

ログ内のキーワード: 401 Client Error

モデルカードを閲覧できても、スクリプトが重みを取得する権限を持つとは限りません。TLS やリポジトリの制限を回避せず、リソースへのアクセス権と認証情報のアカウントを確認してください。

ログ内のキーワード: Bad git executable

あるターミナルでは Git が使えても、すでに起動しているランチャー、サービス、コンテナーからは利用できないことがあります。呼び出し元プロセスの実行ファイル検索パスを確認してください。

ログ内のキーワード: UnetLoaderGGUF

GGUF はコンテナー形式です。任意のチャットモデルファイルが、特定の ComfyUI ノードで拡散モデルやテキストエンコーダーとして使えるとは限りません。

ログ内のキーワード: workflow templates

本体のソース、Desktop のシェル、フロントエンドのパッケージ、テンプレート、カスタムノードは、一体不可分の単一バージョンではありません。更新後に一部のコンポーネントだけ古いままになることがあります。

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

インポートできない場合や wheel のビルドに失敗した場合でも、すぐに Torch を入れ替える必要はありません。ノードが必要とする FlashAttention の実装と、お使いのプラットフォームで利用できるかを確認します。

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

見つからないものが FFmpeg 本体、入力ファイル、エンコーダーのどれかを特定します。ログに ffmpeg と表示されただけでは、動画関連一式を再インストールする理由にはなりません。

ログ内のキーワード: Input contains (near) NaN/+-Inf

非有限値のサンプルを拒否したからといって、コーデックが見つからないとは限りません。入力される音声を、処理とデコードの経路に沿ってさかのぼって確認します。

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

顔処理ノードで使用できる Python バインディングがない場合や、ネイティブコードのビルドに失敗する場合があります。出所が特定できない DLL や wheel で環境を組み立てないでください。

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

ComfyUI を実行する Python 環境を変更する前に、インポート名と配布パッケージ名を照合します。

ログ内のキーワード: No space left on device

出力先のディスクに空きがあっても、ダウンロードキャッシュ、一時ディレクトリ、コンテナーの書き込み可能レイヤー、または別のマウント済みファイルシステムがいっぱいになっていることがあります。

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

設定ノードは、DeepDiff のインポート中、オブジェクトの比較中、または結果の表示中に失敗することがあります。報告された差分は通常、依存関係の失敗ではなくデータです。

ログ内のキーワード: Custom validation failed for node

カスタムバリデーターは拒否を返す場合と例外を発生させる場合があり、ComfyUI はこれらを異なるエラーとして記録します。入力やコードを変更する前に、該当ノードのエラーを確認します。

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

Python バインディング、メディア入力、ネイティブデコード機能をそれぞれ確認します。Torch で CUDA が利用可能でも、Decord の GPU デコード対応が証明されるわけではありません。

ログ内のキーワード: no kernel image is available for execution on the device

GPU 演算に互換性のあるコンパイル済みカーネルがない場合に発生します。デバイスが新しすぎる場合、古いアーキテクチャがビルドから除外されている場合、特定の拡張機能が対応していない場合があります。VRAM 不足とは異なる問題です。

ログ内のキーワード: ControlNet

ControlNet の互換性、制御画像の準備、コンディショニングをそれぞれ切り分けて診断します。ノード間のリンク型エラーは別に確認する必要があります。

ログ内のキーワード: ClipVision model not found.

参照画像を使うワークフローには、想定されたアーキテクチャのビジョンエンコーダーが必要です。CLIPTextEncode に入力されるオブジェクトとは区別してください。

ログ内のキーワード: CLIP input is invalid: None

CLIPTextEncode にワイヤーがつながっていても、有効なエンコーダーが読み込まれたとは限りません。上流の読み込みと、モデルが完全なチェックポイントを使うのか、個別のコンポーネントを使うのかを確認します。

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

失敗したエンドポイントを特定し、バックエンド、ログ、レジストリ、ワークフロー保存の各リクエストを切り分けます。