ComfyUI が動かない？障害切り分け意思決定ツリー

ComfyUI でトラブルが発生した際、根拠なくパッケージの再インストールやコマンドの実行を繰り返すのは最も効率の悪い方法です。本ガイドは、数多くの実例から得られた経験に基づき、問題を体系的に切り分けるための「意思決定ツリー」を提供します。

本ガイドの適用条件

「どこが壊れているのか見当がつかない」 という場合のみ本ガイドを利用してください。 すでに明確なエラー名（例：No module named 'onnxruntime'）がわかっている場合は、直接それぞれの個別解説ガイドへ進んでください。

---

判定 1：ComfyUI は正常に起動するか？

ブラウザで http://127.0.0.1:8188 にアクセスして動作するかどうかを確認します。

• 起動する → ComfyUI の基本システムは正常です。判定 2 へ進みます。
• 起動しない（コンソールがすぐ閉じる等） → まず Python 仮想環境と PyTorch のランタイムを復旧させる必要があります。
  • 対策：常见问题 にある起動エラー対策を確認します。
  • 対策：GPU 兼容性 で NVIDIA ドライバと CUDA の整合性を確認します。
  • 各種インストールガイド：デスクトップ版、ポータブル版、手動インストール

判定 2：ワークフロー上に「赤いノード」が表示される

ワークフローをロードした際、一部のノードが赤色（未登録）になっている場合。

ステップ 1： それは「フロントエンド専用ノード」ですか？

以下のノードはバックエンドでの Python 登録が必要ないため、赤いノードとして表示されても無視して問題ありません：

• Note、Reroute、MarkdownNote
• Fast Groups Muter (rgthree)、Fast Groups Bypasser (rgthree)
• PrimitiveNode、GetNode、SetNode
• workflow> で始まるノード（ローカルラッパー）

ステップ 2： プラグインフォルダ自体は存在しますか？

ComfyUI/custom_nodes/ フォルダの中に対象のカスタムノードがあるか確認します。

• フォルダがない → 該当ノードをインストールします。詳細は 安全安装自定义节点 を確認。
• フォルダはあるが赤ノードになる → 判定 3 へ進みます。

詳細ガイド：

• 如何修复 ComfyUI 工作流中的缺失节点

判定 3：フォルダはあるがノードが認識されない

custom_nodes 内にフォルダがあるのに WebUI に表示されない場合。

起動ログに IMPORT FAILED の行が出ているか確認します。

• ModuleNotFoundError によるインポート失敗 → 依存ライブラリが不足しています。
  • 対策：ComfyUI の Python 環境を明示的に指定して、必要なモジュールをインストールします。
  • 詳細は ComfyUI 依赖冲突 を参照。
• AttributeError や ImportError（コードの競合）によるインポート失敗 → ソースコードのバージョン互換性エラーです。
  • カスタムノードのソースコードが現在の ComfyUI のバージョンと合っていません。
  • プラグインフォルダへ移動し、git pull でコードを最新に更新します（パッケージの再インストールは不要です）。
• インポートエラーは出ていないが赤ノードになる → ノード名（クラス名）の変更です。
  • プラグインのアップデートにより、ノード名が変更された可能性があります。ワークフロー上のノードを置き換えてください。

詳細ガイド：

• 如何修复 ComfyUI 插件导入失败错误

判定 4：ノードは表示されるが実行（Queue）時にエラーが出る

ノードは赤くなっていないが、画像生成を開始するとコンソールや画面にエラーが出る場合。

• エラーログにモデルファイルのパスが含まれる → 依存関係ではなく、単純にモデルファイルが見つからないエラーです。
  • 指定されたパス（models/checkpoints/ 等）に正しいモデルファイルを配置してください。
  • 在 ComfyUI 中安装模型 を参照。この問題に対して pip install コマンドを実行しないでください。
• エラーログに Python の関数やモジュールのエラーが出る → ライブラリ競合の可能性があります。
  • pip show <パッケージ名> で競合しているパッケージのバージョンを確認します。

判定 5：ログに「Starting server」と出るが画面が開かない

コンソール上にサーバー起動完了のログが出ているのに、ブラウザ画面が無限ロードされる場合。

ComfyUI は正常に起動しています。 ただし、起動直後の何らかの処理がロードをブロックしています。

主な原因：

• ComfyUI-Manager が接続データを取得中：中国国内などの環境で GitHub raw ドメインへのアクセスが遮断されタイムアウト待ちになっています。
  • 対策：config.ini 内で network_mode = offline を指定してオフラインモードにします。
• BizyAir プラグインの API 接続ループ：API キーが無効であるか、接続エラーで再試行を繰り返しています。
  • 対策：環境変数 BIZYAIR_SKIP_TRD_MODEL_CACHE=1 を指定してキャッシュ取得をスキップします。

関連ガイド

• 工作流环境搭建
• 依赖冲突
• 常见问题
• GPU 兼容性