知仓学习社知仓学习社
矩阵乘法形状不匹配：mat1 and mat2 shapes cannot be multiplied / 全站资源搜索
搜索 更新 2026-10-02
报错 047 执行期运行时错误（张量/尺寸/节点） 有来源可查

矩阵乘法形状不匹配：mat1 and mat2 shapes cannot be multiplied

报错原文（原样） 
RuntimeError: mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)
检索关键词 mat1 and mat2 shapes cannot be multiplied、shapes cannot be multiplied、(154x2048 and 768x320)、RuntimeError: mat1 and mat2
先看这一句 采样节点（KSampler / SamplerCustomAdvanced）执行时报矩阵乘法维度对不上，图片出不来。
适用版本 全版本通用（架构混搭问题，非版本 bug） · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境

现象与触发场景

常见触发场景：

  • SD1.5 的 ControlNet 配 SDXL checkpoint（或反过来）
  • 文本编码器与主模型不匹配（例如把 t5xxl 同时填进 DualClipLoader 的两个 CLIP 槽）
  • 量化/精度类 UNet 加载器与模型结构不匹配

根因

  • 线性层权重矩阵的输入维度由基础模型架构决定，另一个架构的 ControlNet / 文本编码器送进来的激活维度不同，矩阵乘法直接失败
  • 官方文档把这条报错明确归因到 "Model Architecture Mismatch"：使用来自不同架构家族的模型组合
  • 错误发生在哪个节点看 "Error occurred when executing XxxNode" 那一行；矩阵维度里的 2048/768/320 可以反查是哪一层

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 核对 ControlNet 与 checkpoint 的架构是否一致
    官方文档明确：SD1.5 checkpoint 只能用 SD1.5 ControlNet，SDXL checkpoint 只能用 SDXL ControlNet，给出的对应报错正是 mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)。把 ControlNet 换成与主模型同架构的版本。
  2. 核对 DualClipLoader 两个 CLIP 槽不能填同一种编码器
    官方文档指出：Flux 场景下把 t5xxl_fp8_e4m3fn.safetensors 同时填进两个 CLIP 槽会导致错误，正确做法是一个槽放 t5xxl_fp8_e4m3fn.safetensors、另一个槽放 clip_l.safetensors。
  3. 官方建议的预防做法：先用模板工作流验证
    尝试新模型时，先用 ComfyUI 自带模板工作流或官方示例工作流跑通，再在其基础上改；同一次下载尽量用同一个 Hugging Face 仓库里的完整模型包，避免跨仓库混搭。

验证是否修好

替换为同架构的 ControlNet / 文本编码器后重新运行，采样节点能正常完成，日志中不再出现 cannot be multiplied。

补充说明

同一条报错在 kijai/ComfyUI-HunyuanVideoWrapper#469 出现过实例（1x2048 and 768x3072），属于跨仓库通用症状。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [115] （官方文档）　How to Troubleshoot and Solve ComfyUI Model Issues　https://docs.comfy.org/troubleshooting/model-issues
  2. [125] （节点仓库 issue）　Error: mat1 and mat2 shapes cannot be multiplied (1x2048 and 768x3072)　https://github.com/kijai/ComfyUI-HunyuanVideoWrapper/issues/469

这条报错要用到的东西

按本条报错所属的类别（执行期运行时错误（张量/尺寸/节点））列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

ComfyUI 权重库（167 个文件 / 约 1187 GB）按 ComfyUI 的 models 目录分好类的 167 个权重文件 / 每个文件一份说明（放哪、被哪些工作流引用） 待挂载
工作流对照本条工作流的依赖清单，确认模型版本对得上 板块

同一类别的其他条目

【045】生成时报张量尺寸不匹配：The size of tensor a (X) must match the size of tensor b (Y) at non-singleton dimension Z 有来源 【046】拼接/拼接 latent 时报：Sizes of tensors must match except in dimension 1 有来源 【048】卷积通道数不匹配：Given groups=1, weight of size ..., expected input ... to have N channels 有来源 【049】精度类型不匹配一：expected scalar type Half but found Float 含未核实 【050】精度类型不匹配二：Input type (torch.FloatTensor) and weight type (torch.HalfTensor) should be the same 含未核实
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库