tqdm progress bar BrokenPipe silently discards completed generations in background/MCP mode

该问题出现在 ComfyUI 以后台/非交互方式运行(stderr 管道读端已关闭),且 Manager 的日志钩子(`file_logging` 默认开启)把 tqdm 进度条写入 stderr 时的 `BrokenPipeError` 向上抛出,导致采样实际已完成的 KSampler 任务被标记

快速结论:该问题出现在 ComfyUI 以后台/非交互方式运行(stderr 管道读端已关闭),且 Manager 的日志钩子(`file_logging` 默认开启)把 tqdm 进度条写入 stderr 时的 `BrokenPipeError` 向上抛出,导致采样实际已完成的 KSampler 任务被标记为错误、输出图片未保存。优先排查后台模式的 stderr 重定向方式以及 Manager 日志钩子相关版本。

适用环境:Issue 已确认:ComfyUI 0.34.0(WSL2 / Linux)、ComfyUI-Manager 最新版(提交 `d47c9346 “update DB”`,bug 存在于 HEAD)、后台分离模式启动(`python main.py –listen 127.0.0.1 –port 8188`,stderr 重定向到已关闭的管道)、客户端为 REST `/prompt`(MCP 走同一 API,同样复现)。

最快修复方案:升级到包含 #3568(`main`)和 #3569(`manager-v4`)的 ComfyUI-Manager 版本;这两个修复已合并,随 3.43.2 和 4.4.2 之后的下一个版本发布。

注意事项:修复只覆盖 Manager 在 `file_logging` 开启时安装的日志钩子;关闭 `file_logging` 时,进度条仍会在 ComfyUI 自身的 `app/logger.py` 流中报错,本次改动未处理该路径。修复在 Issue 关闭时尚未发布,需确认实际安装版本包含对应提交。

问题场景

用户以后台/分离方式启动 ComfyUI(例如用 `nohup` 将 stderr 重定向到日志文件,且原终端管道读端已关闭),再通过 REST `/prompt` 或 comfy MCP 提交包含 `KSampler` 的提示词。采样本身正常完成,服务器日志会显示 `Prompt executed in 5.83 seconds`,但轮询 `GET /history/<prompt_id>` 时任务被标记为 `status_str: “error”`,且 `/history/<id>/outputs` 中没有输出图片。

报错原文

tqdm progress bar BrokenPipe silently discards completed generations in background/MCP mode

status_str: "error"
exception_type: BrokenPipeError
exception_message: "[Errno 32] Broken pipe"
executed: ["70", "86", "22", "45", "17", "1", "42"]

k_diffusion/sampling.py  res_multistep()
  → tqdm progress bar (trange)
    → tqdm/std.py display() → print_status() → fp.write()
      → custom_nodes/ComfyUI-Manager/prestartup_script.py
          write_stderr(message)
          original_stderr.flush()      # ← BrokenPipeError here

原因分析

根据 Issue 描述及维护者确认:ComfyUI-Manager 的 `prestartup_script.py` 安装了一个流包装器,把 tqdm 进度条重新输出到 `original_stderr`。在后台/分离模式下,stderr 管道的读端已关闭,每次进度条刷新都会在 `original_stderr.flush()` 处抛出 `BrokenPipeError`。由于异常发生在采样循环内部,未被隔离,会沿执行链向上传播,把整个任务标记为失败,尽管采样已经成功。维护者说明:Manager 的日志钩子把控制台写入失败传递给了打印节点和采样器进度条,这是根因所在。

可能原因还包括:启动时 stderr 指向了生命周期短于 ComfyUI 进程的管道,例如由父进程创建并随父进程退出而关闭的管道。

环境排查

  • 确认 ComfyUI-Manager 版本及提交,是否已包含 #3568(`main`)或 #3569(`manager-v4`);Issue 关闭时修复尚未随正式版本发布。
  • 确认启动方式:stderr 是否被重定向到已关闭的管道,而非持久文件或终端。
  • 确认 Manager 的 `file_logging` 是否为默认开启状态;该钩子仅在开启时安装。
  • 确认客户端路径:REST `/prompt` 与 MCP 共用同一 API,两者均应纳入排查。
  • 查看 `/history/<prompt_id>` 中 `executed` 列表是否包含 KSampler 节点、`exception_type` 是否为 `BrokenPipeError`。

解决步骤

  1. 升级 ComfyUI-Manager 到包含 #3568 或 #3569 修复的版本(随 3.43.2 / 4.4.2 之后的下一个版本发布)。
  2. 如暂时无法升级,可优先尝试:将 stderr 指向真实文件或活跃终端,避免写入已断开的管道。
  3. 如仍需要规避,可优先尝试临时关闭 Manager 的 `file_logging`,但这只是绕开 Manager 的日志钩子,进度条仍可能在 ComfyUI 自身的 `app/logger.py` 流中报错,Issue 中未声称这是完整解决方案。
  4. Issue 正文中曾建议在 `prestartup_script.py` 的 tqdm 分支对 `write_stderr`/`flush` 加 `BrokenPipeError`/`OSError` 捕获;正式修复已由维护者以 #3568/#3569 合并,建议以合并版本为准,不要自行修改源码。

验证方法

在后台/MCP 模式提交一个包含 `KSampler` 的提示词,轮询 `GET /history/<prompt_id>`:应返回 `success` 而非 `status_str: “error”`,且 `/history/<id>/outputs` 中存在输出图片。同时检查 Manager 日志文件中仍保留输出内容,确认日志没有因断管而丢失。Issue 报告者称本地打补丁后生成返回 `success` 并保存 PNG。

参考来源

ltdrdata/ComfyUI-Manager #3223

相关修复:#3568(main)、#3569(manager-v4)

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36596

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注