ComfyUIで赤いノード・Missing Custom Nodeが出たときの直し方

ComfyUIで他人のワークフローを開いたとき、ノードが赤くなったり「Missing Custom Node」と表示されたりすることがある。

この場合、最初にComfyUIそのものを入れ直す必要はない。まず確認したいのは、どのノードが不足しているのか、そのノードをどこから入れるべきなのかという2点だ。

カスタムノードは単なる設定ではなく、Pythonコードを含む拡張機能である。ワークフローに名前が出ているという理由だけで、見つかったものを片っ端から導入するのは避けたい。

まず不足しているノード名を確認する

ComfyUI Managerを利用できる環境では、不足ノードを含むワークフローを読み込んだ際に候補を探せる。

不足ノードの案内からOpen Managerを開くと、対応するパッケージ候補が表示されることがある。Install Allのような一括導入機能があっても、最初から全部入れる必要はない。

先に次の情報を控える。

不足ノード名:
候補パッケージ:
配布元:
ワークフローの入手元:

名前が似ているだけの別パッケージを入れると、問題が解決しないだけでなく、依存関係が増えて切り分けが難しくなる。

配布元とバージョンを確かめる

候補が見つかったら、パッケージ名だけで判断せず、配布元のリポジトリや登録情報も確認する。

特に見たいのは次の点だ。

• ワークフロー作者が案内している配布元と一致するか
• 現在も更新されているか
• 特定のバージョン指定がないか
• 追加で必要なPythonパッケージがあるか

古いワークフローでは、最新バージョンのカスタムノードに変えたことで入出力項目が変わり、そのままでは動かない場合もある。最新版なら必ず互換性がある、とは考えない方がよい。

Managerで候補が出ない場合も、検索結果から推測した無関係なリポジトリを導入するのではなく、元のワークフロー配布ページや公式の手動導入手順と照合する。

依存関係は「使っているComfyUIの環境」へ入れる

カスタムノードによっては、追加のPythonパッケージが必要になる。

依存関係は、PCに入っている任意のPythonへ追加すればよいわけではない。

ComfyUI Desktopは専用のPython環境を管理している。Portable版や手動インストールも、それぞれ実際にComfyUIが使っている環境が異なる。

したがって、まず自分が使っているのが次のどれかを確認する。

• ComfyUI Desktop
• Portable版
• 手動インストール

別のPython環境へ依存パッケージを入れても、ComfyUI側から見えなければ不足は解消しない。

導入後は同じワークフローを読み直す

必要なカスタムノードを追加したら、元のワークフローをもう一度読み込む。

確認すべきなのは「インストール処理が成功した」という表示ではなく、元のワークフローから不足ノードの表示が消えたかである。

まだ問題が残る場合は、症状を分けて見る。

症状	次に確認すること
同じノードが不足扱いのまま	正しいComfyUI環境へ導入されたか
ノードはあるが項目が合わない	バージョン差、ワークフローとの互換性
読み込み時にエラーが出る	Pythonの依存関係、起動ログ
モデル読み込みノードだけ赤い	カスタムノードではなくモデルの保存先

エラーが出たからといって、すぐにVRAM不足やComfyUI本体の破損と決めつけない。原因の層を分ける方が早い。

動いた後も、不要なカスタムノードは増やしすぎない

一つのワークフローを動かすために大量のカスタムノード集を入れると、今後の更新や依存関係の衝突を追う範囲が広がる。

必要なものだけを追加し、どのワークフローのために入れたのかを把握できる状態にしておくと、後のトラブル対応が楽になる。

ComfyUI本体だけでも安定して動いていない場合は、先にWindows版ComfyUI Desktopの導入へ戻り、標準ワークフローが開く状態を確認する。依存関係の衝突が疑わしい場合は、カスタムノードの依存関係トラブルを切り分ける方法も参考になる。