拡張機能の更新後に ComfyUI の画面が真っ白になる:フロントエンドとバックエンドの問題を切り分ける
Python サーバーは動作中でも、キャンバスが表示されないことがあります。関係のないモデルを再インストールする前に、静的アセット、JavaScript 拡張機能、バックエンドが利用できない状態を区別します。
症状と対象範囲
Python サーバーは動作中でも、キャンバスが表示されないことがあります。関係のないモデルを再インストールする前に、静的アセット、JavaScript 拡張機能、バックエンドが利用できない状態を区別します。
検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。
Failed to fetch dynamically imported module
TypeError
blank screen
出典から確認できること
公式トラブルシューティングでは、フロントエンド拡張機能とバックエンドノードをそれぞれ切り分ける手順が示されています。更新手順では、フロントエンド、本体、テンプレートを別々に扱い、ひとつのバージョンとしてまとめていません。出典 1(英語) 出典 2(英語)
区別すべき状況
1. キャッシュやプロキシが、互換性のないフロントエンドリソースを返している。
2. 拡張機能の JavaScript が、フロントエンド API と合わなくなっている。
3. バックエンドの起動、プロキシのルーティング、静的リソースの認証に失敗している。
確認手順
以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。
手順 1. ターミナルで待ち受けアドレスとバックエンドが動作中であることを確認し、ブラウザーの Console と Network のエラーを調べます。
手順 2. プライベートウィンドウや新しいブラウザープロファイルで比較する前に、未保存のワークフローを保護します。作業の唯一のローカルコピーを消去しないでください。
手順 3. 「Settings」を開ける場合は、「Extensions」メニューでサードパーティ製フロントエンド拡張機能を無効にし、再起動してから、グループごとに少しずつ戻します。画面が真っ白で「Settings」を開けない場合は、インストールをバックアップし、公式が案内する、すべてのカスタムノードを無効にする手順で基準状態と比較します。その後、原因を切り分けるためにノードのグループを少しずつ戻します。基準状態で問題が解消すれば原因を絞り込めますが、それだけで特定の拡張機能を特定できるわけではありません。
手順 4. 最初に起きたリソースまたはスクリプトのエラーとバージョンを記録します。ネットワーク設定と依存関係を同時に変更せず、コピーで更新またはロールバックを試します。
完了の確認
キャンバスとノード操作、通常のリクエストが復旧し、再読み込みしてもスクリプトの失敗が再現しないことを確認します。ホームページが表示されるだけでは、拡張機能の検証は完了していません。
制限と注意点
拡張機能を無効にしても、その拡張機能がインストールしたパッケージは元に戻りません。ブラウザーのストレージを消去すると、同期されていない作業が失われる場合があります。
参照した原文資料
- ComfyUI のカスタムノードに関するトラブルシューティング(英語)(確認日:2026-09-26)
- ComfyUI の更新方法(英語)(確認日:2026-09-26)
英語原文の確認:2026-09-26。手順は現行の公式 UI アクセス分岐に基づいています。ローカルでの ComfyUI 実行、GPU テスト、最小メモリ量の測定、修復結果は確認していません。
関連するトラブルシューティング記事とガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
- 127.0.0.1:8188 に接続できない:実行中の ComfyUI サービスを特定する
Connection refusedlocalhost は、リクエストを行うデバイスを指します。ブラウザー、スマートフォン、コンテナー、ノートブック、リモートサーバーでは、その意味が異なります。 - ComfyUI 本体を更新してもノードやテンプレートが見つからない:各コンポーネントのバージョンを個別に確認する
workflow templates本体のソース、Desktop のシェル、フロントエンドのパッケージ、テンプレート、カスタムノードは、一体不可分の単一バージョンではありません。更新後に一部のコンポーネントだけ古いままになることがあります。
この記事は役に立ちましたか?
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に ComfyUI 公式のカスタムノードのトラブルシューティングと更新手順を確認し、「Settings」が使えない場合の代替手順も含めました。確認手順は編集上のものです。ローカルでの ComfyUI 実行、GPU テスト、修復の確定を示すものではありません。
01ComfyUI のカスタムノードに関するトラブルシューティング(英語)出典の確認日: 2026-09-2602ComfyUI の更新方法(英語)出典の確認日: 2026-09-26問題を報告 · 2df42f27-3aa1-5b2b-b27d-87a203f303cb
関連記事
編集者がこのページに関連づけた記事です。
無作為なアンインストールを、制御したグループと再現可能な入力に置き換えます。目的は原因となる最小の組み合わせを特定することであり、すべてのサードパーティ製ノードを一括して判定することではありません。