ノードに class_type がない：API エクスポートのエラーと登録漏れを区別する

症状と対象範囲

API 実行ノードには class_type が必要です。同じ missing_node_type カテゴリでは、リクエストにクラスが含まれていてもバックエンドが認識しないケースが報告されることがあります。message と extra_info を併せて確認してください。

検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。

has no class_type
missing_node_type

出典から確認できること

ComfyUI 本体の validate_prompt は、class_type の欠落を NODE_CLASS_MAPPINGS の検索とは別に確認します。Issue #6366 と #12105 には関連する報告があります。一人のユーザーに役立った更新があっても、全員に nightly 版の更新を勧める根拠にはなりません。出典 1（英語） 出典 2（英語） 出典 3（英語）

区別すべき状況

1. キャンバス UI の JSON が API プロンプトとして直接送信されている。

2. エクスポート、手動編集、またはサードパーティーによる変換で、ノードの技術的な型が失われている。

3. フロントエンドまたはノードがグラフを正しくシリアライズできない。または、バックエンドにクラスが登録されていない。

確認手順

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

手順 1. ファイルの用途を確認し、失敗しているノードで、UI の type、position、links だけでなく inputs と class_type も調べます。

手順 2. 正しく開けるワークフローから、現在のバージョンでサポートされている API 形式を使って再エクスポートします。比較用に元のファイルも残します。

手順 3. class_type がすでにあるのに不明な場合は、/object_info と起動時の登録エラーを調べます。

手順 4. 文書化された修正が該当するノード／バージョンに当てはまる場合に限り更新します。欠落しているすべての型を KSampler で埋めたり、表示ラベルからクラスを推定したりしないでください。

完了の確認

リクエストに有効な型が含まれ、サーバーの検証を通過することを確認します。その後に node_errors が発生した場合は、それぞれに応じた確認が必要です。

制限と注意点

編集可能な表示タイトルは、信頼できる Python クラス名ではありません。形式変換では、フィールド名の変更だけでなく、ノードの入力の意味を考慮する必要があります。

参照した原文資料

• ComfyUI execution.py の検証（英語）（原文資料の確認日：2026-09-21）
• ノードに class_type がない（英語）（原文資料の確認日：2026-09-21）
• カスタムノードのワークフローで class_type が不足（英語）（原文資料の確認日：2026-09-21）

翻訳準備日：2026-09-22。上記の資料確認日は既存の記事から引き継いだもので、この翻訳ですべてを本日再確認したとは主張しません。GPU での実行、最小メモリの測定、実行時の保証は提供していません。

関連するトラブルシューティング記事とガイド

• ComfyUI のワークフローをネイティブ API から送信し、prompt_id を追跡する
• ComfyUI でノードが見つからない：パッケージの欠落・読み込み失敗・クラス未登録を区別する
• POST /prompt が 400 を返す：再試行の前に node_errors を確認する