カスタム検証に失敗：ノード固有のエラー詳細を読む
カスタムバリデーターは拒否を返す場合と例外を発生させる場合があり、ComfyUI はこれらを異なるエラーとして記録します。入力やコードを変更する前に、該当ノードのエラーを確認します。
症状と対象範囲
カスタムバリデーターは拒否を返す場合と例外を発生させる場合があり、ComfyUI はこれらを異なるエラーとして記録します。入力やコードを変更する前に、該当ノードのエラーを確認してください。
検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。
Custom validation failed for node
custom_validation_failed
exception_during_validation
出典から確認できること
本体の検証では、ノードの VALIDATE_INPUTS（またはそれを置き換える新しい検証処理）が呼び出されます。結果が true 以外の場合は custom_validation_failed となり、入力名と返された詳細が記録されます。ノードの検証から例外が漏れると exception_during_validation となり、例外の型と traceback が記録されます。これは別の事象であり、詳細の内容も必ずしも同じではありません。リンクされた入力を再帰的に検証している最中に発生した例外には、別の型 exception_during_inner_validation が使われます。これらは実行前の確認であり、その後に発生するノードや GPU の実行エラーとは異なります。出典 1（英語） 出典 2（英語）
区別すべき状況
1. ノードが、利用できないリソースやサポートされていない入力の組み合わせを意図的に拒否している。
2. 検証コードが現在の本体インターフェースと互換性を持たない。
3. 検証中に起きた環境やリソースのエラーが、一般的なメッセージにまとめられている。
確認手順
以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。
手順 1. node_errors で、ノード ID／クラスと正確なエラー型を記録します。custom_validation_failed の場合は input_name と返された詳細を残します。例外の場合は、提供されていれば exception_type、exception_message、traceback を残します。共有する前に、プライベートなパスやトークンを伏せてください。
手順 2. バリデーターが拒否を返した場合は、指定されたフィールド、リソース、作者が示す入力要件を確認します。例外が発生した場合は、入力だけが誤っていると決めつける前に、関連する traceback の最初のフレームから、失敗したバリデーターまたはリンク先のノードを特定します。
手順 3. 作者が示す元の最小構成の例と比較します。資料に記載された有効な入力でも失敗する場合は、バージョンや環境の競合を検討します。
手順 4. 本体と拡張機能のバージョンを添えて、最小の再現例をそのノードのプロジェクトに報告します。拒否を回避するためにバリデーターを削除しないでください。
完了の確認
元の入力が該当する検証経路を通過し、その後ノードが想定した結果で実行されることを確認します。バリデーターを抑制しても、データが正しいことの証明にはなりません。
制限と注意点
検証によって、ファイル、パラメーター、リモートインターフェースの制約を保護できる場合があります。検証を回避すると、明確な早期エラーが、さらに特定しにくい実行時エラーに置き換わる可能性があります。
参照した原文資料
- ComfyUI execution.py の検証処理（英語）（出典の再確認日：2026-09-27）
- ComfyUI のカスタムノードのトラブルシューティング（英語）（出典の再確認日：2026-09-27）
資料の確認と英語原文の個別編集レビュー：2026-09-27。ローカルでの検証リクエスト、ワークフロー、GPU の実行はありません。
関連するトラブルシューティング記事とガイド
次に考えられる原因を確認
同じ症状にも異なる原因があります。関連する記事を順に確認してください。
- Required input is missing：該当するノードと不足している入力欄を特定する
Required input is missingバックエンドが実行前に必須入力の不足を検出しました。報告されたノードと入力欄を使って該当箇所を修正してから、ほかのエラーを調べます。 - POST /prompt が 400 を返す：再試行する前に error と node_errors を確認する
prompt_outputs_failed_validation拒否されたリクエストは、構造化されたエラー情報を調べる必要があります。HTTP 400 だけではネットワークが不安定だとは判断できず、延々と再送信するべきではありません。
この記事は役に立ちましたか？
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-27 に ComfyUI の execution.py にある検証の戻り値、例外、リンク入力の処理分岐と、公式のカスタムノードのトラブルシューティング資料を再確認し、英語原文を個別に編集レビューしました。ローカルでの実行はありません。
01ComfyUI execution.py の検証処理（英語）出典の確認日: 2026-09-2702ComfyUI のカスタムノードのトラブルシューティング（英語）出典の確認日: 2026-09-27問題を報告 · c235af7a-9289-5884-bb11-55c4b8a034f6
関連記事
編集者がこのページに関連づけた記事です。
無作為なアンインストールを、制御したグループと再現可能な入力に置き換えます。目的は原因となる最小の組み合わせを特定することであり、すべてのサードパーティ製ノードを一括して判定することではありません。