参数超范围或类型错误：先读节点允许值，再改数字

现象与适用范围

转换失败与超出当前节点范围要分开检查；先核对请求实际提交的值，不要直接改节点定义或统一截断数字。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

invalid_input_type
value_smaller_than_min
value_bigger_than_max

已核对的依据

核心先转换字面量 INT、FLOAT、STRING 和 BOOLEAN，再在适用时比较 min、max；自定义节点的验证器可能接管字段并施加自己的规则。BOOLEAN 使用 Python bool(value)：非空字符串 "false" 也会变成 true，应发送真正的 JSON 布尔值。表单看起来像数字，不代表提交值有效。 C01

需要区分的情况

1. API 把空字符串、带单位文本或区域化小数格式当作数字发送。

2. 复制的工作流使用另一个节点版本允许的范围。

3. 前端输入与服务端定义不一致，或自定义验证器有额外限制。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 读取 node_errors，记录错误类别、input_name、有提供时的 received_value，以及原请求里的 JSON 值和类型；修改前保存工作流的私有副本。

第 2 步。 将提交值与当前节点输入定义比较：invalid_input_type 先看 INT/FLOAT 转换；value_smaller_than_min 或 value_bigger_than_max 看该字段现行边界；自定义校验错误则按该节点自己的规则排查。

第 3 步。 在请求副本中发送语义明确的原生 JSON 数字或布尔值，并确认符合当前节点要求；不要假设看起来像数字的字符串或 "false" 会按预期转换。

第 4 步。 确认字段意义后再应用批量修正；参数变化可能影响输出，不能为了让校验通过就无差别截断所有数值。

如何判断处理有效

该条校验错误消失，实际提交值仍表达预期含义，并确认原任务在修改后行为正确。

注意事项与尚未确认的部分

默认值是作者的起点，不等于所有任务的最佳值。不同错误中提到的限制应随版本保存，不做永久数值表。

资料复核并独立审阅中文：2026-09-27。本站未提交本地 API 请求、执行工作流或运行 GPU。

原始资料

• C01 · ComfyUI execution.py validation。复核：2026-09-27。

相关排查与操作

• POST /prompt 返回 400：读取 node_errors，区分校验和执行失败
• Required input is missing：定位缺失输入，而不是反复点运行