ComfyUI の再接続エラー:画面フリーズ問題の修復方法
ComfyUI 画面が「再接続中(Reconnecting)」のままフリーズするエラーの修復。サーバーのクラッシュ、127.0.0.1 のバインド、Websocket、プロキシ競合の解決。
30秒クイック判定
まずは ComfyUI のコンソール画面(黒い画面)を確認してください。コンソールにエラー情報(Traceback)が出ている、あるいはウィンドウ自体が消えている場合は、ブラウザではなくバックエンド(Python)がクラッシュしています。コンソールが正常に動いている場合は、VPN、プロキシ、ファイアウォール、ブラウザ拡張機能等による通信妨害をチェックしてください。
ComfyUI の WebUI 画面が 「Reconnecting...(再接続中...)」 のまま停止する場合、ブラウザと ComfyUI Python サーバー間のリアルタイム通信(Websocket)が切断されています。すぐに再インストールするのではなく、サーバーのログを確認して原因を特定しましょう。
画面が Failed to fetch とだけ表示し、Reconnecting... かどうか分からない場合は、まず ComfyUI「Failed to Fetch」 で失敗したリクエストを特定してください。
主な原因は以下のいずれかです:
- ComfyUI サーバー(バックエンド)がクラッシュ、フリーズ、または自動再起動した。
- ブラウザが Websocket 接続を正常に維持できていない(プロキシ、VPN、ブラウザ拡張機能などの障害)。
クイック診断表
| 症状 | 推定される原因 | 優先確認事項 |
|---|---|---|
| 画面に「Reconnecting...」と出てコンソールが勝手に閉じている | サーバーのクラッシュ | コンソールに記録されたエラーログの確認 |
| ページを再読み込み(F5)すると再接続される | フロントエンドの websocket 切断 | ブラウザ拡張機能、プロキシ設定のチェック |
| 新しいノードをインストールしてから発生するようになった | カスタムノードまたは UI 拡張の競合 | 起動オプションに --disable-all-custom-nodes を付与してテスト |
| 画像生成中に「Reconnecting」になる | VRAM 不足(OOM)、GPU ドライバーのリセット | コンソールの最初のエラーを確認 |
| 外部アクセス(LAN内、リモート)の時のみ発生する | ファイアウォール、プロキシ、VPN の通信妨害 | ローカルの 127.0.0.1 で起動テスト |
修復手順
ステップ 1:サーバーの生存確認とローカルテスト
ComfyUI のターミナルコンソールを開きます。コンソール自体が消えている場合は、サーバーが強制終了しています。 コンソールが動いている場合は、ブラウザで以下のローカルホストアドレスを開いてテストします:
http://127.0.0.1:8188リモート接続やカスタム IP ではなく、まずは 127.0.0.1 を使用してください。これにより、ネットワークの問題なのか、ComfyUI 本体の問題なのかを切り分けることができます。
ステップ 2:最初の本質的なエラーの特定
エラーログの一番下の行だけを見るのではなく、上に向かってログをスクロールし、最初に発生した深刻なエラー(ModuleNotFoundError や CUDA out of memory など)を確認してください。これがクラッシュの真の原因である可能性が高いです。
ステップ 3:カスタムノードをすべて無効化してテスト
特定のカスタムノードや Python パッケージの更新によって接続障害が発生するケースが非常に多いです。
起動引数に以下を追加して、手動またはバッチファイルから起動してください:
python main.py --disable-all-custom-nodesポータブル版の場合:
起動用バッチファイルをコピーし、引数に --disable-all-custom-nodes を書き加えて実行します。
これで問題が解決する場合、ComfyUI コアは正常であり、最近導入・更新した特定のカスタムノード(またはその依存ライブラリ)に問題があります。1つずつ有効化して原因ノードを特定してください。
ステップ 4:ブラウザと Websocket 設定の確認
サーバー自体は動いているがブラウザ接続が回復しない場合、以下を試してください:
Ctrl + F5によるブラウザキャッシュの強制クリア- シークレットウィンドウ(拡張機能をすべて無効化した状態)でのアクセス
- VPN、ローカルプロキシ(科学インターネットツール)、厳格なウイルス対策ソフトの Web フィルタリングの一次停止
ステップ 5:ポート衝突の解決
ポート 8188 が他のプログラムによって占有されていると、ComfyUI は正常にバインドできません。
Windows のコマンドプロンプトで以下を実行し、ポートが他のプロセスに使用されていないか確認します:
netstat -ano | findstr :8188ポート競合がある場合は、異なるポートを指定して起動します:
python main.py --port 8189その後、ブラウザで http://127.0.0.1:8189 を開いて接続を検証します。
ステップ 6:生成中の GPU / メモリクラッシュの対策
画像生成ボタン(Queue)を押した瞬間に接続が切れる場合は、GPU の高負荷による一時的リセットや VRAM 枯渇(OOM)が発生しています。
以下の対策を試してください:
- 生成画像の解像度やバッチサイズを下げる
- 起動引数に
--lowvramを指定して、グラフィックメモリのフットプリントを抑える - バックグラウンドで動作している他の 3D アプリやブラウザなどの GPU 使用ソフトを閉じる
関連ガイド
実際の ComfyUI 環境で起きている問題なら、まず無料で Wonderful Launcher を使って確認してください。ランチャー内の修復フロー、タスクログ、実行環境チェックを一か所で確認できます。クレジットは画像生成と従量ツール用です。
Wonderful Launcher をダウンロードクレジットプランを見るDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.