ControlNet 报错或不起作用：核对底模、控制图和应用节点

现象与适用范围

增加 ControlNet 后出现维度错误，或者结果没有明显受到姿态、线稿、深度等输入控制。应把“计算不兼容”与“控制图不符合要求”分开诊断。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

ControlNet
size mismatch

已核对的依据

官方 ControlNet 教程说明不同控制类型使用不同参考图，并明确核心不包含全部预处理器。预处理器、ControlNet 权重和生成底模是不同组件，不能仅安装一个控制节点就视为依赖齐全。单独的维度错误不足以定位不兼容组件，应保留报错节点和完整回溯。 D19 D03

Return type mismatch between linked nodes 是源节点输出类型与目标输入类型的连线校验结果，不能据此认定 ControlNet 权重与底模家族冲突。先核对报错所指的插槽。C01

需要区分的情况

1. ControlNet 权重面向另一种底模家族或专用变体。

2. 模型需要边缘、深度或姿态输入，却直接收到未经正确处理的普通图片。

3. 应用节点没有连接到实际采样条件，或强度与生效区间让控制在本次请求中几乎没有参与。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 先用没有 ControlNet 的基础流程确认底模工作，再保存副本加入单个控制分支。

第 2 步。 核对控制权重作者声明的底模和输入类型，同时查看预处理结果，而不是只查看原始图片。

第 3 步。 检查 Apply 节点输出是否进入实际使用的条件链路，采用该模型示例的时间区间和强度。

第 4 步。 单一控制成功后再叠加多种控制，分别记录每个分支；出现 shape 错误时先定位报错节点与组件版本；只有回溯指向模型结构冲突时，才恢复文档支持的兼容组合，不靠调整图片宽高掩盖问题。

如何判断处理有效

最小流程不再出现结构异常，控制图可解释，输出与开关控制的对照有可检查差别。

注意事项与尚未确认的部分

若报错为 Return type mismatch between linked nodes，先按连线类型指南核对节点插槽，再排查模型权重。控制效果不是精确复刻保证。不同家族的通用控制、专用控制与适配器不能仅按相似名字互换。

资料核对日期：2026-09-25。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D19 · ComfyUI ControlNet example。核对：2026-09-25。
• D03 · ComfyUI model troubleshooting。核对：2026-09-25。
• C01 · ComfyUI v0.37.0 execution.py validation。核对：2026-09-25。

相关排查与操作

• ControlNet 入门：先看控制图，再看生成结果
• mat1 and mat2 shapes cannot be multiplied：按模型链路查维度