Dependency cycle detected：報告されたノード ID をグラフでたどる

症状と対象範囲

通常のデータ依存ループが有効な実行順序を妨げます。これは、明示的に定義された動作を持つ、サポート対象のループ／制御フローノードとは異なります。

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

Dependency cycle detected
dependency_cycle

出典から確認できること

現在の validate_inputs は、走査中に通常の依存関係の循環を検出します。エラーの details には読みやすい ID／クラスのパスが、extra_info.cycle_nodes には重複のない ID が入ります。cycle_path は内部変数であり、レスポンスのフィールドではありません。ComfyUI 本体のループ検証は別の手順で行われ、依存関係の循環がすでに存在する場合はスキップされます。専用のループやサブグラフの動作は、それぞれの実装を確認してください。出典 1（英語）

区別すべき状況

1. 下流の出力が上流の必須入力に再接続されている。

2. API グラフ生成器が誤った ID またはリンクを再利用し、自己依存を作っている。

3. 専用の制御フロー構造が、通常の依存関係に誤って平坦化されている。

確認手順

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

手順 1. 元のグラフを保存します。node_errors 内の dependency_cycle エントリーで、details のパスと extra_info.cycle_nodes の ID を読み取り、その ID とクラス型を現在のグラフに対応付けます。表示タイトルは一意とは限りません。

手順 2. 循環に含まれるすべてのエッジを確認し、誤った再接続、古い ID、コピーされた参照がないか調べます。

手順 3. 作者の最小例を出発点にして、そのバージョンでサポートされている制御フロー、または有限回に展開したグラフで反復を表現します。

手順 4. 再エクスポートして検証し、エッジを削除したことで必須入力が不足していないか確認します。

完了の確認

通常の依存関係にある無効な循環がなくなり、意図した反復の動作が維持され、グラフが結果を生成することを確認します。

制限と注意点

これは確認した ComfyUI 本体の内容に基づいています。古いバージョンでは別のエラーが使われる場合があります。任意のワイヤを切断するとタスクの内容が変わる可能性があるため、元のグラフを保存してください。

参照した原文資料

• ComfyUI execution.py の検証（英語）（出典の再確認日：2026-09-27）

出典と英語の編集内容を別途確認した日付は 2026-09-27 です。ローカルのグラフ検証、ワークフローの実行、GPU を使った実行は行っていません。

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

• Bad linked input：API 接続はソースノードと出力スロットで表す
• Required input is missing：該当するノードと不足している入力欄を特定する