Required input is missing：定位缺失输入，而不是反复点运行
服务端在执行前发现节点缺少必需输入。错误通常会给出节点和输入名；先修复这个明确缺口，再判断是否还有上游问题。
现象与适用范围
服务端在执行前发现节点缺少必需输入。错误通常会给出节点和输入名；先修复这个明确缺口，再判断是否还有上游问题。
检索用原文或片段（具体编号、数值和文件名随环境变化）：
Required input is missing
required_input_missing
已核对的依据
核心 validate_inputs 会对当前节点声明为 required 的输入执行存在性检查。/prompt 校验失败会返回 node_errors，这些信息比通用的“执行失败”横幅更接近问题位置。 C01 D09
需要区分的情况
1. 画布上某个必需插槽没有连线，或对应参数没有导出。
2. API 客户端在构造 inputs 时遗漏字段、传错层级或误删空值。
3. 节点升级后新增必需输入，旧工作流尚未迁移到新接口。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。
第 1 步。 展开错误 details，记录实际节点 ID、类名和缺少的 input_name。
第 2 步。 在当前服务端 /object_info 或节点界面核对输入定义，区分可选与必需项。
第 3 步。 使用正确类型的上游输出连接该插槽，或按节点定义提供字面值；不要仅添加同名但无效的 null。
第 4 步。 重新导出并再次提交，确认新请求体的 inputs 已包含所需字段；若新增输入来自升级，保存模板修订说明。
如何判断处理有效
校验不再报告该输入缺失，并且关联上游也通过校验。一个必需字段补齐后可能继续显示其他真实错误。
注意事项与尚未确认的部分
不同节点的同名输入不保证意义相同。不要为了通过校验随意添加占位图片、随机模型或虚构文件路径。
资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。
原始资料
- C01 · ComfyUI execution.py validation。核对：2026-09-21。
- D09 · ComfyUI Server API routes。核对：2026-09-21。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- Return type mismatch：检查连线插槽，不要只看节点颜色
Return type mismatch between linked nodes上游输出的接口类型与下游输入声明不同，服务端拒绝执行。例如 IMAGE、LATENT、MODEL 和 CONDITIONING 在工作流里承担不同角色，不能仅因界面允许拖动就视为可互换。 - POST /prompt 返回 400：先读 error，再看 node_errors
prompt_outputs_failed_validation原生 ComfyUI API 拒绝提交工作流。HTTP 400 只说明这次请求不符合要求，具体原因应从 error 与 node_errors 中提取，不能一律当成网络不稳定重试。
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排；没有执行、硬件测试或保证修复的结论。
01ComfyUI execution.py validation资料核对: 2026-09-2102ComfyUI Server API routes资料核对: 2026-09-21