ComfyUIでMissing Nodesが出たら、ノードを入れていないのか、入れたノードの読み込みに失敗したのかを分けます。
フォルダーが存在するだけでは、ComfyUIで使える状態になっているとは限りません。
この記事ではローカル環境を中心に、不足ノードの特定、Managerでの確認、Python依存関係、バージョンの違いを順に調べる方法を説明します。
Missing NodesとMissing Modelsは別の問題
| 表示・状態 | 不足しているもの | 主な確認 |
|---|---|---|
| Missing Nodes | 処理を実行するノード | 拡張の導入、本体の対応、読み込みログ |
| Missing Models | モデルファイル | ダウンロード、保存先、選択モデル |
| IMPORT FAILED | ノードの読み込みに問題 | Python依存関係、互換性、起動時の例外 |
| 実行中のエラー | 入力や処理条件の問題など | 停止したノードとエラーレポート |
大きなモデルを追加しても、ノードが読み込まれていなければ問題は解決しません。
まず画面に表示された不足項目をそのまま控えます。
1．ワークフローの配布元と必要環境を確認する
配布ページで、必要なカスタムノード、ComfyUIのバージョン、モデル、Desktop・Cloudなどの対象環境を確認します。
Cloudとローカルでは、利用できるノードやモデルが同じとは限りません。
公式サポートも、不足ノードがある場合は、導入済み拡張とワークフローが作られた環境を確認するよう案内しています。
ノード名だけが分かる場合は、配布元の説明やリポジトリのREADMEで提供する拡張名を調べます。
表示名とインストールするパッケージ名が一致するとは限りません。
2．Managerで必要な拡張を確認する
利用中の環境にComfyUI Managerがある場合は、不足ノードを調べる機能やノード管理画面で、該当する拡張を確認します。
UIは版によって異なるため、現在の画面に合う手順を使ってください。
- 不足しているノード名を控える。
- そのノードを提供する拡張を確認する。
- 作者、配布元、必要環境を読む。
- 必要な拡張だけを導入する。
- ComfyUIを再起動し、ブラウザーも更新する。
- 同じワークフローを開き、状態を確認する。
カスタムノードは処理を追加するプログラムです。
インストール前に機能と配布元を確認します。
導入方法はComfyUI公式のカスタムノード導入ガイドを参照してください。
3．インストール済みなのに出ない場合は起動ログを見る
ComfyUIを起動したターミナルやログで、対象拡張の読み込みに失敗していないか確認します。
画面のMissing Nodesだけでは、未導入と読み込み失敗を区別できません。
IMPORT FAILEDやModuleNotFoundErrorなどがある場合は、その直前から表示されている例外を読みます。
必要なPythonライブラリがないのか、対応しないバージョンなのかを確認してください。
複数のエラーが並んでいても、最初の1つが原因で後続が失敗している場合があります。
最後の行だけを見て、別のパッケージを次々と追加しないようにします。
4．Pythonの依存関係はComfyUIの環境へ入れる
カスタムノードには、ノードのファイル本体とは別に、Pythonライブラリが必要な場合があります。
システム全体のPythonへインストールしても、ComfyUIが別のPythonを使っていれば届きません。
Desktop、Portable、手動で作った仮想環境では、依存関係を入れる先が違います。
使用中の導入方式を確認し、ノードのREADMEと公式手順に従って、その環境へ追加します。
エラーを消すためだけに、システムのPythonやPyTorchを無条件で更新しないでください。
正常に動いているモデルや別ノードとの互換性が変わる場合があります。
5．本体とカスタムノードの版を確認する
新しいワークフローが、古いComfyUIにはない標準ノードを使っている場合もあります。
一方、新しい本体へ更新したことで、古いカスタムノードが対応しなくなることもあります。
「全部最新版なら必ず動く」と考えず、ワークフロー作者が確認した組み合わせを調べます。
更新前に、動いていたワークフロー、モデルの場所、導入済み拡張を記録しておきます。
本体、拡張、Python依存関係を同時に大量更新すると、何が変わったのか追いにくくなります。
問題に関係する部分を絞って比較します。
6．競合が疑われるなら、構成を小さくして比較する
拡張を追加した直後からおかしくなった場合は、最近追加・更新したものを確認します。
基本のワークフローが動くか、追加ノードが必要なときだけ失敗するかを比較してください。
公式ガイドにはカスタムノードによる問題の切り分け方法が整理されています。
必要に応じて、拡張を無効にした状態や、最小限の構成で比較します。
カスタムノードのフォルダーを無計画に削除すると、必要な設定や独自の変更を失う場合があります。
元へ戻せる状態を残してから調査します。
似たノードへ置き換えるときの注意
名前や見た目が似ていても、入力・出力の型、画像の扱い、モデルの対応が違うことがあります。
置き換えた線がつながるだけで、同じ結果になるとは限りません。
元ノードが何をしていたかを確認し、短い・小さい入力で結果を比較します。
置き換えたワークフローは別名保存し、元の配布データと区別してください。
直ったかを確認する
- 不足ノードの警告が消えた。
- 起動ログで対象拡張が正常に読み込まれている。
- 必要なモデルと入力素材を選択できる。
- 小さな条件で最後まで実行できた。
- 導入した拡張と確認したバージョンを記録した。
Missing Nodesは、インストール作業だけでなく、読み込みと実行まで確認して解決と判断します。
ノード名、拡張名、使用するPython環境を分けて見ると、同じトラブルを繰り返しにくくなります。
