ComfyUI が起動しない？起動失敗の原因特定と迅速な復旧方法

起動時に ComfyUI startup failed、ComfyUI won't start、または ComfyUI fails before Starting server と表示された場合、単なる一般的なインストール不良として扱わないでください。まず、コンソールに表示された最初の致命的なエラー（最初の例外エラー）を特定し、それぞれの対応ページへ進んでください。

起動失敗のほとんどは、初期状態の環境から何らかの変更が加わったことで発生します：

• カスタムノードが特定の主要パッケージを書き換えた
• バイナリパッケージが現在のランタイムと不一致になった
• Torch または CUDA のバージョンが競合（漂移）した
• 起動に必要な補助ファイルやブートストラップがセキュリティソフト等にブロック・隔離された

したがって、真の問題は単なる 「どうやって起動するか」 ではなく、 「最後に正常に動いていた状態から、起動に失敗する状態になるまでの間に何が変わったか」 です。

検索意図に応じた対応ガイド

典型的な起動失敗のパターン

テレメトリデータおよびサポート事例において、発生頻度が非常に高い起動エラーのパターンは以下の通りです：

「起動失敗」の症状の分類

起動失敗には以下のいくつかのパターンがあります：

• アプリのウィンドウが開いた直後に勝手に閉じる
• ComfyUI の WebUI 画面が一向に表示されない
• ターミナルにサーバー起動（Starting server）のログが出る前にインポートエラーで止まる
• ComfyUI Desktop が読み込みの途中でフリーズする
• 起動に必要なブートストラップファイルが見つからないと警告される

ステップ 1：エラーログの分類

修復を行う前に、エラーを以下のいずれかのカテゴリーに分類します。

カテゴリー A：起動時の Python インポート失敗

例：

ModuleNotFoundError: No module named 'sqlalchemy'
comfyui-frontend-package is not installed
ModuleNotFoundError: No module named 'cv2'

これはパッケージの欠落や破損を意味します。欠落しているのが ComfyUI 本体の起動に必要なコアパッケージである場合は、個別のノード対策ではなく 修复破损的 ComfyUI 便携版依赖 に従い修復を行います。

カテゴリー B：基本ランタイムの破損

例：

Torch not compiled with CUDA
CUDA is not available
AttributeError: module 'torch' has no attribute '...'

Torch や CUDA などの最も基本的な実行パッケージが上書き等により破損しています。

カテゴリー C：プラグインのロード失敗による起動停止

例：

• 特定のカスタムノードのインポートエラーが原因で起動プロセス全体が不安定になる
• 1つのプラグインを入れた（または更新した）後、他の複数のプラグインが同時にエラーを吐くようになった

これは ComfyUI 插件导入失败 または ComfyUI 依賴衝突 の対象になります。

カテゴリー D：ブートストラップまたはセキュリティソフトによる阻害

例：

• 起動バッチファイルや exe ファイルが見つからない
• セキュリティソフトの検知履歴に隔離された記録がある

セキュリティソフトによる誤検知を疑い、検知・隔離ログを確認してください。

推奨される効率的なトラブルシューティング手順

1. ターミナルログから最初の致命的なエラーを特定する。
2. それが基本ランタイム、プラグインの依存関係、またはセキュリティソフト等の阻害のいずれであるか分類する。
3. 影響範囲が最も狭い修復方法から順番に実行する。
4. インストール完了後に再起動し、新しい起動ログの最初の行を確認する。

これにより、関係のないパッケージまで乱発して環境を完全に破壊してしまうことを防げます。

ステップ 2：最初の本質的なエラーの特定

よくある誤りは、エラーログの「一番最後の行」だけをコピーして検索することです。最後の一行は結果としての二次症状であるケースが多いためです。

ログを上に向かって遡り、最も初期に発生したエラーを確認します：

• 最初の IMPORT FAILED
• 最初の ModuleNotFoundError
• 最初の Torch、CUDA、または DLL ロードエラー

これら初期のエラーを解決することで、以降の連鎖エラーがまとめて解消されることがあります。

ステップ 3：最小限の修復の実施

単一パッケージの欠落の場合

不足しているパッケージのみを、ComfyUI を動かしている正確な Python 環境にインストールします。 最初から広範囲アップグレードをしないでください。まず最初の実ブロッカーに対応するパッケージ、またはその依存関係を持ち込んだプラグインの requirements だけを修復します。広範囲アップグレードは、1つの起動失敗を複数の別問題に変えがちです。

Torch または CUDA の破損の場合

カスタムノードのデバッグを行う前に、まず Torch ランタイムそのものの修復を最優先で行います。

重大な注意

再インストールはすべての環境をリセットできますが、すでに多くのカスタムノードをダウンロードしていたり、モデルファイルを配置している場合は最も時間の無駄になる選択肢です。

再インストールを検討するのは以下の状況に限られます：

• 基本ランタイムの破損が深刻で、修復手順が特定できない場合
• コアブートストラップファイルが消失し、安全な復旧ができない場合
• 重ねてインストールを行った結果、環境全体の衝突が手に負えなくなった場合

それ以外の場合は、現在の環境を修復する方がはるかに短時間で復旧できます。

関連ガイド

• 修复损坏的 ComfyUI 便携版依赖而不重装 Torch
• ModuleNotFoundError: ComfyUI 中缺少 'sqlalchemy' 模块
• 如何修复 ComfyUI 插件导入失败错误
• ComfyUI 依赖冲突
• ComfyUI 重连错误
• 常见问题

参照元

• ComfyUI 公式トラブルシューティングドキュメント