トラブルシューティング
エラーログから参考記事を探す。
エラーの原文を貼り付けるか、症状を入力してください。照合はブラウザー内で行い、ログの送信や修復の実行はしません。
ブラウザー内で照合 · 入力は URL、ブラウザーの保存領域、分析イベントに記録しません。消去するかページを離れると入力は破棄されます。エクスポートには記事への参照のみを含めます。第三者のブラウザー拡張機能は当サイトの管理対象外です。
記事を検索するだけで、Python、モデル、GPU の環境は検査しません。表示順は診断結果や修復の成功率を示しません。
カテゴリから探す
トラブルシューティング記事をカテゴリから探す
この言語で公開済みのエラー関連記事を問題の種類ごとにまとめています。カテゴリを開くと記事を確認できます。
環境とデバイス18 件
- Bad linked input：API 接続はソースノードと出力スロットで表す
- ComfyUI のアーカイブを展開できない：展開先より先にアーカイブを確認する
- CUDA out of memory：モデルの読み込み・サンプリング・VAE デコードを切り分ける
- Float8 は MPS で未対応：保存された重みと計算時の dtype を区別する
- Hugging Face の 401／403：ブラウザーでのアクセスとダウンロードプロセスの認可は別
- MPS backend out of memory（Mac）：ユニファイドメモリの負荷を考慮する
- No space left on device：キャッシュ、一時ファイル、出力先のボリュームを確認する
- Prompt has no outputs：実際に実行できる出力先を指定する
- Required input is missing：該当するノードと不足している入力欄を特定する
- Torch not compiled with CUDA enabled：ビルドと対象バックエンドを確認する
- torch.cuda.is_available() が False：ビルド、ドライバー、実行環境を確認する
- Windows エラー 1455：ページファイルの枯渇は CUDA out of memory ではない
- Windows がランチャーをブロックした：例外を追加する前に発行元を確認する
- Windows のパスが長すぎる：短いインストール先と長いパスへの対応を区別する
- xFormers はインストール済みなのに利用できない：ネイティブ拡張と演算子を確認する
- サンプリング完了後に VAE がメモリ不足になる：デコードを分けて診断する
- 数値入力の検証に失敗する：ノードの実際の型と範囲を使う
- 戻り値の型が一致しない：出力元のスロットと接続先の入力を確認する
依存関係とカスタムノード50 件
- aiohttp と requests：ライブラリ不足は接続失敗ではない
- argostranslate が見つからない、または言語ペアがない：該当する層を特定する
- blend_modes は読み込めるのにブレンドに失敗する：画像配列の仕様を確認する
- ComfyUI Manager のボタンが見つからない：UI の変更と読み込み失敗を区別する
- ComfyUI でノードが見つからない：パッケージの欠落・読み込み失敗・クラス未登録を区別する
- decord で動画を読み込めるのに GPU を使えない：インストール済みビルドを見分ける
- deepdiff の失敗：インポート、オブジェクト比較、結果のシリアライズ
- dlib のインストールに失敗する：バインディング、ネイティブビルド、モデル素材を分けて確認する
- DLL load failed：DLL を個別にダウンロードせず、ネイティブ拡張を特定する
- flash_attn をインストールできない：実装、プラットフォーム、ビルド要件を確認する
- InsightFace のインストールまたは初期化に失敗する：パッケージと FaceID 用ファイルを分けて確認する
- Kornia の読み込みエラー：基本パッケージ、Torch、オプションの追加機能を確認する
- llama_cpp の失敗：インストール、ネイティブビルド、モデル読み込みを区別する
- Manager が Git を見つけられない：ComfyUI を起動する環境を確認する
- Manager の Windows Overlapped operation エラー：文書化されたイベントループ設定を確認する
- Manager のセキュリティポリシーで操作がブロックされる：権限と範囲を確認する
- MediaPipe と NumPy：依存関係の制約とバイナリー読み込みエラーを区別する
- MMCV のインストールと演算子不足のエラー：ビルドの組み合わせを確認する
- No matching distribution found：Python のタグ、プラットフォーム、パッケージ名を確認する
- No module named hydra：hydra-core を確認し、次に設定検索パスを確認する
- No module named yaml、PIL、pydantic_settings：配布パッケージ名を確認する
- NumPy の ABI エラー：_ARRAY_API と dtype size changed
- nvvfx が見つからない：インポート名をパッケージ名と決めつけず、ラッパーを特定する
- ONNX Runtime はインポートできるのに GPU 実行に失敗する：プロバイダーとセッションを確認する
- OpenCV の配布パッケージを重ねずに cv2 のインポートを修正する
- OpenGL_accelerate が見つからない：Python の高速化拡張ではグラフィックスドライバーを修復できない
- pip ResolutionImpossible：ダウンロード速度ではなく、競合する要件を解決する
- pip の証明書検証に失敗：TLS を無効にせず証明書の信頼設定を修正する
- Protobuf Descriptors cannot be created directly：生成コードの所有元を特定する
- pytorch_lightning または lightning が見つからない：ノードが実際に使う読み込みパスを確認する
- Qwen Image 2.1 の不足ノード：本体、フロントエンド、サブグラフの対応を分けて確認する
- Qwen TTS と Transformers の競合：ComfyUI をダウングレードする前にバージョン固定を確認
- rotary_embedding_torch が見つからない、または 回転埋め込みのテンソルの次元が一致しない
- safetensors パッケージの不足か、重みファイルの読み込み失敗か：分けて原因を調べる
- SageAttention または Triton のインポート失敗：プラットフォームとビルドの組み合わせを確認する
- SAM と GroundingDINO の失敗：コード、チェックポイント、拡張機能を分けて確認する
- SciPy、einops、torchsde：インポートの不足と演算の失敗を区別する
- SenseVoice-ONNX と setuptools：インストール済みの配布パッケージとソースを比較する
- simpleeval：モジュール不足と無効な式を区別する
- soundfile のエラー：Python パッケージ、libsndfile、音声入力を分けて確認する
- Spandrel はインストール済みなのにモデルを読み込めない：アーキテクチャの対応状況を確認する
- SQLAlchemy と Alembic の失敗：変更する前にローカルデータを保護する
- timm が見つからない、モデル名が不明、または重みをダウンロードできない
- TorchScale と timm の競合：利用元ごとの厳密なバージョン指定は一括アップグレードでは解決しない
- Transformers のエラー：読み込み、API 変更、モデルのダウンロードを切り分ける
- webcolors をインストールしても CSS3_HEX_TO_NAMES がない：API の変更を確認する
- インストール後も Nunchaku が失敗する：ノード、wheel、モデルの組み合わせを確認する
- カスタム検証に失敗：ノード固有のエラー詳細を読む
- パッケージを導入したのに ComfyUI で ModuleNotFoundError が出る
- 更新後に名前をインポートできない：読み込み元のコードと依存関係を一緒に確認する
モデル、ファイル、ワークフロー16 件
- CLIP input is invalid: None：テキストエンコーダーの接続元をたどる
- CLIP Vision が見つからない、または互換性がない：プロンプト用テキストエンコーダーとは別のもの
- ControlNet が失敗する、または目に見える効果がない：ベースモデル、制御画像、適用経路を確認する
- Dependency cycle detected：報告されたノード ID をグラフでたどる
- Expected all tensors to be on the same device：分岐の境界を調べる
- Float、Half、BFloat16 の不一致：失敗した操作を追跡する
- GGUF ファイルを読み込めない：アーキテクチャと専用ローダーを一致させる
- IPAdapter モデルが見つからない：統合プリセットと手動ローダーでは規則が異なる
- LoRA の効果がない、またはサイズ不一致が報告される：ベースモデルと両方の出力経路を確認する
- mat1 and mat2 shapes cannot be multiplied：モデルコンポーネントの連鎖を調べる
- Qwen Image 2.1 のテンソル／デコード失敗：コンポーネント一式を確認する
- Safetensors のヘッダーエラー：ローダーを変更する前にファイルを検証
- VAE と潜在画像のチャンネル不一致：系統名だけでなく正確なバリエーションを確認する
- Value not in list：ComfyUI の選択肢にモデルが表示されないとき
- ノードに class_type がない：API エクスポートのエラーと登録漏れを区別する
- 画像をドラッグしてもワークフローが復元されない：メタデータが残っているか確認する
画面、接続、API10 件
- 127.0.0.1:8188 に接続できない：実行中の ComfyUI サービスを特定する
- Address already in use：停止する前にプロセスを特定する
- ComfyUI Failed to fetch：再インストールする前にリクエストを特定する
- ComfyUI のワークフロー保存に失敗：トラブルシューティングの前にキャンバスを保全する
- ComfyUI 本体を更新してもノードやテンプレートが見つからない：各コンポーネントのバージョンを個別に確認する
- Manager がノード一覧を読み込めない：ノードを再インストールする前に取得処理を調べる
- POST /prompt が 400 を返す：再試行する前に error と node_errors を確認する
- WebSocket は接続するのに結果が届かない：プロンプトごとの終了状態を追跡する
- キューがすぐ完了するのに新しいファイルがない：キャッシュと出力先を確認する
- 拡張機能の更新後に ComfyUI の画面が真っ白になる：フロントエンドとバックエンドの問題を切り分ける
生成、動画、出力7 件
- FFmpeg が見つからない：ComfyUI のプロセス環境で実行ファイルを確認する
- FFmpeg の音声に NaN または Inf が含まれる：エフェクトとデコードを上流までたどる
- No kernel image is available：各バイナリーの GPU アーキテクチャ対応を確認する
- No module named av：FFmpeg をインストールしても Python のインポートが直らない理由
- VHS の出力音声がほぼ無音：ゲインを上げる前に音声の dtype を確認する
- 画像が黒い・色が無効：サンプリング、VAE、表示の失敗を切り分ける
- 動画のエクスポートに失敗する、または正しく再生できない：フレーム、エンコード、音声を分けて確認する