队列卡住：任务一直 pending、Cancel 无效，只能重启

invalid prompt: {'type': 'prompt_outputs_failed_validation', 'message': 'Prompt outputs failed validation', 'details': '', 'extra_info': {}}

现象与触发场景

常见触发场景：

• 前一个任务因自定义节点报错或显存问题卡死，但队列状态没被正确释放
• 工作流里有节点在等待外部资源（模型下载、网络请求）而无限阻塞
• 前端按钮与新菜单/旧菜单不匹配，导致 Cancel、Queue、History 这类操作本身失效
• 提交的 prompt 校验失败被忽略，队列里留下无效条目

根因

• 执行体本身卡死。官方文档 comms_overview 说明队列由 execution.py 中的 PromptExecutor 管理，客户端一次把整个工作流（含全部 widget 值）提交给服务端；一旦某个节点在服务端阻塞，前端除了点击取消之外没有别的干预手段，取消也依赖服务端配合
• 前端控制按钮失效的独立成因。ComfyUI_frontend#8911 的标题即记录了 "Since versions after 1.37.11 + the queue function, history, cancel button and 'set the shapes' function is broken with the old menu"，说明新旧菜单与前端版本组合会让这些按钮直接失效
• 校验失败的任务进入队列后表现异常。ComfyUI#13078 的评论里出现 "Custom validation failed for node: image - Invalid image file" 紧跟 prompt_outputs_failed_validation，说明校验不过的节点会以自定义校验失败的形式在队列/执行链路里表现出来

解决步骤

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

1. 先用 HTTP 接口读队列与历史的真实内容，而不是只看界面
   官方 comms_routes 文档列出 /prompt 会返回 prompt_id 与队列位置，队列与历史也都有 HTTP 接口。用 curl 读一次能看到队列里到底有几个任务、是否真的在执行，从而区分「后端队列卡住」与「前端不刷新」。
   curl -s http://127.0.0.1:8188/queue
   curl -s http://127.0.0.1:8188/history
   curl -s http://127.0.0.1:8188/prompt
2. 清空队列后重启整个进程，并保留出错时的控制台输出
   界面上先清空队列再重启 ComfyUI 进程（重启程序，不只是刷新网页）。重启前把后端终端里最后几行 traceback 完整复制出来，队列卡死的原因基本都在那里；官方故障排查文档反复强调的是先拿日志再定位，而不是先重启了事。
   curl -X POST http://127.0.0.1:8188/interrupt
   curl -X POST http://127.0.0.1:8188/queue -H "Content-Type: application/json" -d '{"clear": true}'
3. 如果是按钮本身失灵，按新旧菜单与前端版本这两条线排查
   根据 ComfyUI_frontend#8911，Queue/History/Cancel 按钮失效与前端版本加菜单模式（新菜单/旧菜单）的组合有关。先在设置里切换菜单模式试一次，若无效再用 --front-end-version 把前端钉到一个已知正常的版本，并优先升级带前端扩展的自定义节点，因为官方文档把这类节点列为前端问题的主要来源。
   --front-end-version Comfy-Org/ComfyUI_frontend@1.39.3
4. 确认不是校验失败造成的假卡住
   如果队列里任务立刻失败但界面不刷新，按报错里的节点名去查该节点的输入是否合法。ComfyUI#13078 的例子中节点自定义校验失败会打印 "Custom validation failed for node:" 与具体文件名，修好输入（或换一张合法图片）就能正常入队执行。

验证是否修好

补充说明

ComfyUI_frontend#8911 采集时 GitHub API 已限流，只取到 issue 标题与搜索结果摘要，未取到正文与维护者回复，故该条目的按钮失效描述严格限于标题原文范围，未扩展成版本结论。队列接口的可用性依据官方 comms_routes 文档中 "The prompt queue is defined in execution.py, which also defines the PromptExecutor class" 与该页列出的核心 API 路由。

来源

1. [203] （官方 issue）　Since versions after 1.37.11 + the queue function, history, cancel but　https://github.com/Comfy-Org/ComfyUI_frontend/issues/8911
2. [200] （官方文档）　ComfyUI Server Routes (HTTP and WebSocket API)　https://docs.comfy.org/development/comfyui-server/comms_routes
3. [193] （官方文档）　Server Overview　https://docs.comfy.org/development/comfyui-server/comms_overview
4. [196] （官方 issue）　Load Image (From Output) has no Preview　https://github.com/Comfy-Org/ComfyUI/issues/13078

这条报错要用到的东西

按本条报错所属的类别（前端界面、浏览器与工作流加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库