参考資料

ControlNet が失敗する、または目に見える効果がない：ベースモデル、制御画像、適用経路を確認する

ControlNet の互換性、制御画像の準備、コンディショニングをそれぞれ切り分けて診断します。ノード間のリンク型エラーは別に確認する必要があります。

更新日 2026-10-01公開版: 3参照元の版: 7

症状と対象範囲

互換性のない計算と、必要なエッジ、ポーズ、深度表現になっていない入力を区別します。

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

ControlNet
size mismatch

出典から確認できること

公式の ControlNet 手順では、制御画像の種類を区別し、ComfyUI 本体にすべてのプリプロセッサが含まれるわけではないと説明しています。プリプロセッサのコード、ControlNet の重み、ベースモデルはそれぞれ別の依存関係です。形状エラーだけでは、どのコンポーネントに互換性がないかは特定できません。エラーが発生したノードと traceback 全体を記録してください。出典 1（英語）出典 2（英語）

別の Return type mismatch between linked nodes 検証では、接続元の出力型と接続先の入力型を比較します。このエラーは、ControlNet の重みとベースモデルの系統が一致しないことを示すものではありません。まず、エラーに記載されたソケットを確認してください。出典 3（英語）

区別すべき状況

1. 制御モデルが、別のベースモデル系統または特殊なバリアントを対象としている。

2. エッジ、深度、ポーズなどの処理済み画像を想定するモデルに、通常の写真を入力している。

3. Apply の出力が実際に使われるコンディショニング経路に届いていない。または、強度や適用タイミングのために制御の効果がほとんどない。

確認手順

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

手順 1. ControlNet を使わずにベースのワークフローが動くことを確認し、保存したコピーに制御ブランチを一つ追加します。

手順 2. 作者が指定するベースモデルと入力画像の種類の要件を確認し、元画像だけでなくプリプロセッサの出力画像も調べます。

手順 3. Apply の出力が、サンプリングに実際に使われるコンディショニングへつながっているかをたどります。まずモデルの例にある強度と適用区間を使います。

手順 4. 一つが動いてから、追加の制御を加えます。形状エラーが出た場合は、エラーが発生したノードとコンポーネントのバージョンを特定します。traceback がモデルアーキテクチャの競合を示す場合は、資料に記載された互換性のある組み合わせに戻します。エラーを隠すためだけに画像サイズを変えないでください。

完了の確認

最小構成のフローが動き、制御画像が適切な内容を示し、制御あり・なしの比較で確認できる違いがあることを確認します。

制限と注意点

メッセージが Return type mismatch between linked nodes の場合は、モデルの重みを調べる前にノード間リンクの型に関するガイドを参照してください。制御によって結果が完全に再現される保証はありません。汎用制御、特殊な制御、別の系統のアダプターは、名前が同じでも互換性があるとは限りません。