ComfyUI でノードが見つからない：パッケージの欠落・読み込み失敗・クラス未登録を区別する

症状と対象範囲

読み込んだワークフローに未解決のノードがある場合、またはバックエンドがノードの種類を見つけられない場合に使うガイドです。まずワークフローのコピーと入手元を保存してください。ノードの不足表示だけで、そのファイルがコンピューター上にないとは判断できません。

検索の手掛かりとなる表示の例です。ノード ID や名前は環境によって変わります。

Missing Node Types

出典から確認できること

ComfyUI の実行コードは技術的な class_type を NODE_CLASS_MAPPINGS と照合します。フォルダーがあっても、起動時の読み込みに失敗してノードが登録されていない場合があります。公式のカスタムノード問題のガイドは読み込み失敗と依存関係の問題を区別し、インストールガイドはノードのコードと Python 依存パッケージの両方が必要だと説明しています。

区別すべき状況

1. ワークフローが必要とする第三者のノードクラスのパッケージが、現在のインスタンスにない。

2. パッケージはダウンロード済みでも、Python の読み込みエラーによってクラスが登録されていない。

3. ブラウザーが別のインスタンスにつながっているか、ワークフローが別の ComfyUI 本体・ノードのバージョンを必要としている。

確認手順

以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。

手順 1. 作成者が画面上で変更できる表示名だけでなく、正確な class_type とノード ID を控えます。ワークフローの作成者が示したパッケージ一覧と元のリポジトリを確認します。

手順 2. 実際に動いている ComfyUI のパスを特定します。そのインスタンスの custom_nodes フォルダーと起動ログを調べ、最初の読み込みエラーから解決します。

手順 3. リポジトリの出所を確認してから、そのインスタンスで使う Python に対応版と明示された依存パッケージを導入します。Manager で検索できないからといって、名前が似た別のリポジトリを無作為にインストールしないでください。

手順 4. ComfyUI を再起動し、ノード検索または自分のローカルバックエンドの /object_info でクラスを確認してから、ワークフローのコピーを開きます。まだ解決しない場合は、ComfyUI 本体、フロントエンド、ノードのバージョンを記録します。

完了の確認

バックエンドがクラスを認識し、元のワークフローがノードの種類の検証を通ることを確認します。その後にモデルの不足や実行エラーが出る場合は別の段階の問題であり、ノードのインストール失敗を示す証拠とは限りません。

注意点

表示名だけではリポジトリを一意に特定できない場合があります。改名されたノード、未登録のノード、保守が止まったノードについては作成者の確認が必要なことがあります。出所が検証されていないコミュニティー ZIP を代用品にしないでください。

参照した原文資料

• ComfyUI カスタムノード問題のガイド（英語）
• ComfyUI カスタムノードのインストールガイド（英語）
• ComfyUI execution.py（英語）

資料を確認した日付は 2026-09-25 です。この記事はノードを実際にインストールまたは実行して検証した記録ではありません。

関連記事

• パッケージ導入後も ComfyUI で ModuleNotFoundError が出る場合（英語）
• ノードに class_type がない場合（英語）
• カスタムノードをコード・依存関係・登録の三段階で導入する（英語）