ComfyUIがうまく動かないときの切り分け｜カスタムノードを外した確認

＊2026年9月29日に確認した内容です。ComfyUI の公式ドキュメント「カスタムノードの問題のトラブルシューティング」「ComfyUI Manager トラブルシューティング」によります。画面は、編集部の PC（Windows 11）のポータブル版（Python ごと1つのフォルダに入った Windows 向けの ComfyUI。ComfyUI v0.37.0・フロントエンド 1.52.7・画面の表示は日本語）で撮りました。

ComfyUI がうまく動かないときは、まずカスタムノード（コミュニティの作者が作って公開しているノード）を全部外して起動し、問題が消えるかを確かめます。消えれば、原因はカスタムノードのどれかです。そのあと、カスタムノードを半分ずつ戻して試す二分法で、原因のカスタムノードを1つに絞り込みます。見つけたら、更新する・ほかのカスタムノードに置き換える・作者に知らせる・外す、のどれかで直します。

まずカスタムノードを全部外して動くか確かめる

公式ドキュメントでは、カスタムノードの問題を調べる最初の手順を、全部のカスタムノードを止めて起動し、問題が消えるかを見ることとしています。起動の引数（起動のコマンドの後ろに付ける指定）--disable-all-custom-nodes を付けると、custom_nodes のフォルダのカスタムノードを読まずに起動します。フォルダの中のものは消えないので、引数を外して起動すれば元に戻ります。

ポータブル版では、ComfyUI_windows_portable のフォルダでターミナルを開き（フォルダの中の右クリックのメニューから開ける）、次のコマンドを実行します。

.\python_embeded\python.exe -s ComfyUI\main.py --disable-all-custom-nodes

毎回コマンドを打たずに済ませる方法も、公式ドキュメントにあります。

1. ComfyUI_windows_portable のフォルダにある、起動に使う run_nvidia_gpu.bat（CPU で動かすときは run_cpu.bat）をコピーし、名前を run_nvidia_gpu_disable_custom_nodes.bat にする
2. コピーしたファイルをメモ帳で開き、中身を次のようにして保存する
3. できたファイルをダブルクリックすると、カスタムノードを止めて起動する

.\python_embeded\python.exe -s ComfyUI\main.py --disable-all-custom-nodes  --windows-standalone-build
pause

Comfy Desktop（ComfyUI のデスクトップアプリ）では、公式ドキュメントによると、設定のメニューからカスタムノードを止めて起動できます。手動インストールでは、ComfyUI のフォルダで python main.py --disable-all-custom-nodes を実行します。

編集部は、ポータブル版を --disable-all-custom-nodes を付けて起動しました。画面の左のサイドバーの「コンソール」を押して起動の記録を開くと、「Skipping loading of custom nodes」（カスタムノードを読まずに飛ばす）と出ていました。

公式ドキュメントでは、結果を次のように読みます。

• 問題が消えた：原因はカスタムノード。次の「二分法で原因のカスタムノードを絞り込む」の手順に進む
• 問題が残る：原因はカスタムノードではない。公式ドキュメントの「トラブルシューティングの概要」を見る。直らなければ、下の「問題を知らせる」の見出しの先に知らせる

二分法で原因のカスタムノードを絞り込む

二分法は、カスタムノードを半分ずつ試して、原因のカスタムノードを1つに絞り込む方法です。公式ドキュメントの手順では、止めているカスタムノードの半分を戻して ComfyUI を起動し、問題が出るかを見ます。問題が出れば原因は戻した半分に、出なければ止めたままの半分にあります。原因のある側をまた半分に分けて、1つになるまでくり返します。

公式ドキュメントでは、カスタムノードを次の2つに分けて調べるとしています。

公式ドキュメントでは、フロントエンドの拡張で起きる問題のほうが多いため、そちらから調べるとしています。

フロントエンドの拡張から調べる

フロントエンドの拡張を調べるときは、半分ずつ戻して試すたびに ComfyUI を再起動しなくても、画面を読み込み直すだけで確かめられます。公式ドキュメントの手順は、次のとおりです。

1. 画面の左のサイドバーの「設定」を押し、設定の画面の「拡張」を開く。ほかの人が作った拡張のスイッチを全部切る
2. 最初に止めたあとだけは、止めたことが確実に効くように、ComfyUI を再起動する。問題が消えれば、原因はフロントエンドの拡張にある。消えなければ、次の「ふつうのカスタムノードを調べる」に進む
3. 拡張の半分のスイッチを入れ、画面を読み込み直して、問題が出るかを見る。これをくり返して、原因の拡張を絞り込む

編集部の画面では、「拡張」に、拡張機能の名前が一覧で並び、行ごとに入り切りのスイッチがありました。上の「すべて」「コア」「カスタム」のタブで、一覧を絞れます。公式ドキュメントによると、名前が似ている拡張は、同じカスタムノードのものであることが多いです。画面が開かないときは、この方法は使えないので、次の方法で調べます。

ふつうのカスタムノードを調べる

公式ドキュメントでは、Comfy CLI（ComfyUI をコマンドで操作する道具）を入れていれば、comfy-cli node bisect のコマンドで二分法を自動で進められるとしています。コマンドの使い方は、次のとおりです。

• comfy-cli node bisect start：二分法を始める
• comfy-cli node bisect good：問題が消えたときに実行する
• comfy-cli node bisect bad：問題が残ったときに実行する
• comfy-cli node bisect reset：終わったら実行して元に戻す

コマンドに慣れていないときは、手で進めます。Windows での手順は、次のとおりです。

1. ComfyUI のフォルダで、custom_nodes をコピーして custom_nodes_backup の名前にし、控えを取っておく。別に custom_nodes_temp のフォルダを作る
2. custom_nodes の中のカスタムノードのフォルダの半分を、custom_nodes_temp に移す
3. ComfyUI をふつうに起動して、問題が出るかを見る
4. 問題が残れば、原因は custom_nodes に残した側にある。残した側の半分を custom_nodes_temp に移す。問題が消えれば、原因は移した側にある。移した側の半分を custom_nodes に戻す
5. 3 と 4 を、原因のカスタムノードが1つになるまでくり返す

原因のカスタムノードを直す

原因のカスタムノードが見つかったら、公式ドキュメントでは、次の4つのどれかで直すとしています。

ComfyUI-Manager での更新と止め方は、「ComfyUI-Manager｜カスタムノードの管理」の記事で、パッケージの版がぶつかったときのことは、「ComfyUIの依存関係｜PythonとPyTorchのパッケージ」の記事で解説しています。

問題を知らせる

公式ドキュメントでは、問題の知らせ先を、原因ごとに次のように分けています。

カスタムノードの作者に知らせるときは、ComfyUI の版・エラーの文と記録・問題が起きるまでの手順・OS を書きます。公式ドキュメントは、知らせる前に、そのカスタムノードの説明と Issues のページで、同じ問題が知らされていないかを見ることも勧めています。

ComfyUI-Managerがうまく動かないとき

ComfyUI-Manager 自体がうまく動かないときは、公式ドキュメントの「ComfyUI Manager トラブルシューティング」に、次の直し方があります。config.ini は ComfyUI-Manager の設定のファイルで、ComfyUI v0.3.76 からは ComfyUI/user/__manager/ の中にあります。

公式ドキュメントによると、custom_nodes に入れた ComfyUI-Manager が次のようになっていると、動いているように見えても更新されず、二重に入る原因になります。

• ファイルが custom_nodes のすぐ下に直に置かれている
• フォルダが二重になっている（custom_nodes/ComfyUI-Manager/ComfyUI-Manager）
• フォルダ名が ComfyUI-Manager-main になっている
• ZIP を展開せずに置いている

Git の URL から入れようとして止められるのは、ComfyUI-Manager のセキュリティのレベルのためです。レベルのことは、「ComfyUIのカスタムノードの仕組みと入れ方｜入れる前の注意」の記事で解説しています。