知仓学习社知仓学习社
报错后不知道是哪个节点炸的：如何用 "Error occurred when executing" 定位 / 全站资源搜索
搜索 更新 2026-10-02
报错 053 执行期运行时错误（张量/尺寸/节点） 有来源可查

报错后不知道是哪个节点炸的：如何用 "Error occurred when executing" 定位

报错原文（原样） 
Error occurred when executing KSampler:
mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)
检索关键词 Error occurred when executing、!!! Exception during processing !!!、Traceback (most recent call last)、Prompt executed in、execution.py
先看这一句 点了运行之后只看到一大段 traceback，不知道是画布上哪个节点出的问题，也不知道该改哪个参数。
适用版本 全版本通用（属于排障方法，不涉及版本差异） · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境

现象与触发场景

常见触发场景：

  • 任何执行期报错——这一条是所有其它条目的通用定位方法
  • 报错内容为中文或无信息量的封装提示，需要回到终端看原始日志

根因

  • ComfyUI 把异常在 UI 上折叠展示，真正有信息的是终端里的完整 traceback
  • 报错信息的前两行就够定位：第一行 "Error occurred when executing <节点名>" 说明是哪个节点，第二行（异常消息本体）说明失败原因（shape / channel / dtype 等）
  • traceback 最底部的帧指向实际出错源码文件与行号，custom_nodes/ 下的路径说明是插件、ComfyUI/ 下的路径说明是本体

解决步骤

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

  1. 只看报错的前两行
    社区排障笔记（comfyui.nomadoor.net）明确说明：运行期错误第一眼要看错误信息的前两行——第一行 Error occurred when executing KSampler 告诉你出错的节点，第二行 mat1 and mat2 shapes cannot be multiplied (...) 告诉你失败原因。把这两行拿去搜索通常就能找到原因。
  2. 以终端日志为准，不要只看 UI 里的红框
    UI 的红色错误窗口点 Close 就没了，而终端里保留完整日志。同一条报错在 UI 与终端内容一致，但终端能往上翻看更早的上下文（例如哪个模型被加载、哪个插件被导入）。
  3. 用 traceback 最后一帧区分"本体 bug"还是"插件 bug"
    看 traceback 最下面那条 File 路径：指向 ComfyUI/execution.py、comfy/ 等本体目录，说明是核心问题（去 Comfy-Org/ComfyUI issues 搜）；指向 custom_nodes/<插件名>/ 说明是插件问题（去该插件仓库 issues 搜）。搜索时把 is:open 去掉，连已关闭的 issue 一起搜，命中率更高。
  4. 仍然定位不了时做自定义节点二分排查
    按 docs.comfy.org 的官方流程：先用 --disable-all-custom-nodes 启动做基线，如果问题消失说明是插件导致，然后每次启用一半插件（二分法）直到复现，即可锁定具体插件。前端扩展类插件（带 UI 改动的最先怀疑）优先排查。
    python main.py --disable-all-custom-nodes

验证是否修好

你能说出"是哪个节点 + 什么错误"这两点；按定位结果修改后重跑不再复现。

补充说明

error_text 的两行示例结构直接来自 comfyui.nomadoor.net 的 error-handling 页面（该页以 "Error occurred when executing KSampler:" 与 mat1 and mat2 shapes... 两行为例讲解）。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [132] （社区）　What to do when an error occurs　https://comfyui.nomadoor.net/en/notes/error-handling/
  2. [68] （官方文档）　Troubleshooting Custom Node Issues　https://docs.comfy.org/troubleshooting/custom-node-issues
  3. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues　https://docs.comfy.org/troubleshooting/overview

这条报错要用到的东西

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

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 有来源 【047】矩阵乘法形状不匹配：mat1 and mat2 shapes cannot be multiplied 有来源 【048】卷积通道数不匹配：Given groups=1, weight of size ..., expected input ... to have N channels 有来源 【049】精度类型不匹配一：expected scalar type Half but found Float 含未核实
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库