报错 052 执行期运行时错误（张量/尺寸/节点）有来源可查

上游节点返回空：'NoneType' object has no attribute 'shape'

报错原文（原样）

Exception during execution: 'NoneType' object has no attribute 'shape'
（注：以上为转述文本，非逐字原文。）

检索关键词 'NoneType' object has no attribute 'shape'、NoneType、has no attribute 'shape'、Exception during execution

先看这一句 执行到某个节点时突然报 NoneType，日志里看不出是哪个输入没接，但能看出是哪一类节点在取 .shape。

适用版本 全版本通用；某些具体实例在特定版本修复过（如 #1836） · 核实日期 2026-09-26 · 状态已核实

适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境

现象与触发场景

常见触发场景：

某个必填输入没连（例如把图像输入留空、mask 没接）
上游节点因为条件分支没走到而返回 None
bypass（Ctrl+B）掉了一个仍被下游引用的节点

根因

节点内部对输入张量直接取 .shape，而上游实际给出的是 Python 的 None，于是抛出 AttributeError
Comfy-Org/ComfyUI#3033 的记录显示：即便在 #1836 修复之后，'NoneType' object has no attribute 'shape' 仍会复现，说明这类问题在多个节点里都存在
定位方法：看 "Error occurred when executing <节点名>" 那行确认是哪个节点，然后在画布上检查该节点的每一个输入口是否有连线、连的是不是被 bypass 的节点

解决步骤

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

先看是哪一行在取 shape，再回画布查这个节点的输入
traceback 最后一行会写明类似 xxx.shape 的表达式，对应节点里对某个输入做的操作。回到画布，检查该节点的每个输入口：是否悬空、是否连到了被 Ctrl+B 旁路的节点、是否连到了条件开关（如 Impact Pack 的开关类节点）的未选中分支。
升级本体与相关插件到最新版，并复现一次
Comfy-Org/ComfyUI#3033 说明这类 None 传递问题在不同版本反复修补过（#1836 等），因此第一步应是更新到最新版再测；如果仍复现，则按 issue 模板附上完整 traceback 与工作流 JSON 提交。
用二分法排除是哪个插件引入了这个空值
若确认连线和 bypass 都正常，改用 --disable-all-custom-nodes 启动做基线，再用二分法逐半启用插件，直到复现。官方排障文档把这一类"节点返回异常值"归入自定义节点排查流程。
python main.py --disable-all-custom-nodes

验证是否修好

补上缺失连线或取消 bypass 后重跑，该节点能正常拿到张量、不再抛 NoneType；或升级版本后原工作流可直接跑通。

补充说明

error_text 取自社区排障页与 issue 标题的常见写法（Exception during execution: 'NoneType' object has no attribute 'shape'），未逐字核对单一 issue 正文，故标 error_text_verbatim=false。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。

[130] （官方 issue）　'NoneType' object has no attribute 'shape' Issue persists after #1836 　https://github.com/Comfy-Org/ComfyUI/issues/3033
[131] （节点仓库 issue）　error : 'NoneType' object has no attribute 'shape'　https://github.com/ltdrdata/ComfyUI-Inspire-Pack/issues/138

这条报错要用到的东西

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

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 含未核实

这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库