mat1 and mat2 shapes cannot be multiplied:按模型链路查维度
采样、文本编码或加载适配器时出现矩阵形状不兼容。数字反映当前参与计算的维度,是定位线索,但不能只凭一组数字推出唯一缺失模型。
现象与适用范围
采样、文本编码或加载适配器时出现矩阵形状不兼容。数字反映当前参与计算的维度,是定位线索,但不能只凭一组数字推出唯一缺失模型。
检索用原文或片段(具体编号、数值和文件名随环境变化):
mat1 and mat2 shapes cannot be multiplied
size mismatch
已核对的依据
官方模型排错将矩阵和张量形状错误与模型组合不匹配联系起来;issue #12076 也有实际矩阵错误报告。用户报告与官方通用诊断都没有授权我们随意改变张量形状来修补模型结构。 D03 I14
需要区分的情况
1. 底模、文本编码器、ControlNet、IPAdapter 或 LoRA 来自不同家族或变体。
2. 工作流节点升级后输入结构改变,旧图仍使用此前组合。
3. 某扩展内部构造了不符合预期的张量,只有在恢复最小匹配流程后才能与资源错配区分。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案,不代表上游已经为你的环境确认了原因。
第 1 步。 保存完整形状、失败节点、调用栈及最近改动,避免只留下“size mismatch”四个字。
第 2 步。 按模型链路列出 diffusion、text encoder、VAE 和各适配器,逐个标记作者声明的兼容家族。
第 3 步。 移除可选适配分支,用作者原始模型组合运行最小样例,然后一次恢复一个扩展以定位触发点。
第 4 步。 如果原始组合也失败,比较核心和节点版本及模板修订,提交具体复现;不要盲目 reshape、截断向量或替换网络层。
如何判断处理有效
全部组合具备匹配依据且最小样例通过;恢复某一组件后稳定重现时,可把问题缩小到该边界。
注意事项与尚未确认的部分
形状修补可能让程序勉强执行却改变模型语义。不同错误中的 768、2048 等数值不能当成永久固定诊断表。
资料核对日期:2026-09-21。本站未执行此工作流,未进行 GPU、最低显存或耗时测试。
原始资料
- D03 · ComfyUI model troubleshooting。核对:2026-09-21。
- I14 · ComfyUI Desktop 矩阵形状报错用户记录。核对:2026-09-21;原始日期:2026-01-25。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- LoRA 不生效或形状不匹配:先核对底模,再检查两条加载分支
lora key not loadedLoRA 能在列表中选择,却运行时报形状错误,或者输出几乎没有变化。本页合并处理“资源不匹配”和“流程没有真正应用”两类问题;没有变化只是观察结果,不必然证明 LoRA 损坏。 - ControlNet 报错或不起作用:核对底模、控制图和应用节点
ControlNet分别排查 ControlNet 与底模兼容性、控制图预处理和条件链路;节点连线类型错误应单独诊断。 - CLIP input is invalid: None:加载的 checkpoint 可能没有文本编码器
CLIP input is invalid: NoneCLIPTextEncode 等节点收到空的 CLIP 输入。需要检查编码器是否真的加载成功、连线是否正确,以及当前模型是否采用分体加载,而不是只看节点框上有没有一根线。
这篇内容对你有帮助吗?
匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排;没有执行、硬件测试或保证修复的结论。
01ComfyUI model troubleshooting资料核对: 2026-09-2102ComfyUI Desktop 矩阵形状报错用户记录资料核对: 2026-09-21