Bad linked input：API 连线必须表达节点 ID 与输出槽

现象与适用范围

通过 API 构造 inputs 时，列表值被当作节点连接，但不符合连接结构。特别是业务参数本身为数组时，不能假设任何 JSON 列表都会被当作普通值原样传入。

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

Bad linked input
bad_linked_input

已核对的依据

当前核心校验把普通列表输入按连线处理；列表长度不等于 2 时返回 bad_linked_input。普通连线应是 [源节点 ID, 输出槽索引]。若字面数组恰好有两项，它可能被当成连线并引发另一类错误；同一源码支持对目标节点接受的字面值使用 {"__value__": [...] } 包装。还须确认目标输入本来就接受该值。服务端 POST /prompt 会校验提交的 prompt，失败时返回错误。核心校验 服务端路由

需要区分的情况

1. 将 UI links 数组直接复制到 API inputs。

2. 连线列表长度错误，例如缺少槽位或混入 UI link 的其他字段。长度为 2 但源 ID 或槽位无效，可能转成别的错误。

3. 字面数组直接作为普通列表提交：非二元素列表会触发 bad_linked_input，二元素列表则可能被当作连线。

建议的操作顺序

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

第 1 步。 在原生 UI 建立一个能通过校验的最小工作流并导出 API，观察目标输入实际序列化结构。

第 2 步。 对普通节点连接核对源 ID 确实存在，槽位是当前节点有效的输出位置。

第 3 步。 对目标节点接受的字面数组，比较当前 API 导出与核心的 {"__value__": [...]} 包装；不要假设普通 JSON 列表会原样传入。

第 4 步。 发送前检查请求结构，把列表长度错误与源 ID 不存在、槽位无效、返回类型不匹配和节点值校验失败分别记录。

如何判断处理有效

服务端不再报告 bad_linked_input，且输入没有在修复过程中从业务数组变成错误连线。

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

本文只解释本轮核心代码的规则，不承诺所有嵌套子图、自定义列表节点或后续格式都能用同一手写转换器处理。

2026-09-26 复核源码并审阅中文。本站未提交本地 API 请求、运行工作流或 GPU，也未测最低显存或耗时。

原始资料

• C01 · ComfyUI execution.py validation。复核：2026-09-26。
• D09 · ComfyUI Server API routes。复核：2026-09-26。

相关排查与操作

• 把工作流接入原生 API：从正确导出到取得 prompt_id
• Return type mismatch：检查连线插槽，不要只看节点颜色