ComfyUI 升级 v0.4.0 踩坑记录：解决 TypeError: QM_Queue.task

记录于：2025年12月17日

ComfyUI version: 0.4.0

暂未适配v0.4.0的队列管理器旧版插件
comfyui_queue_manager

另一个可尝试替代的队列管理器
ac-comfyui-queue-manager

Comfy.ICU队列管理器介绍

ComfyUI 升级 v0.4.0 踩坑记录：解决 TypeError: QM_Queue.task_done() got an unexpected keyword argument 'process_item' 报错

前言

最近 ComfyUI 发布了v0.4.0大版本更新。我原本还在用比较老的版本（大概是 v0.3.64 左右），经过尝试和搜索得知，只有该版本（v0.4.0）才支持Z-Image的相关工作流，心血来潮想升级一下源代码部署版。结果这一升级，直接把环境搞崩了。

启动正常，但在点击“Queue Prompt”开始生图时，控制台直接红字刷屏，任务死活跑不起来。经过一番排查（和求助 AI 大佬），终于搞定了。特此记录，希望能帮到遇到同样报错的小伙伴。

报错现象

ComfyUI 启动后，后台出现自动恢复任务或手动点击生成时，控制台抛出如下核心错误：

Exception in thread Thread-27 (prompt_worker): Traceback (most recent call last): ... File "H:\PythonProjects1\Win_ComfyUI\main.py", line 236, in prompt_worker q.task_done(item_id, TypeError: QM_Queue.task_done() got an unexpected keyword argument 'process_item'

症状总结：

界面能打开，节点能连。
一点生成，进度条不走。
后台报错提示task_done()函数多了一个不认识的参数process_item。

原因分析

这个报错的根本原因是：ComfyUI 的“核心代码”与“插件/依赖文件”版本不匹配（Version Mismatch）。

通俗点说，就是出现了“跨频道聊天”：

发送者（main.py）：我升级到了 v0.4.0，不仅告诉你要“完成任务”，还顺便传了一个新参数process_item让你处理敏感数据。
接收者（旧版execution.py或旧版插件）：我还停留在 v0.3.x 时代，我只知道“完成任务”，你给我的这个process_item是什么鬼？我不认识，直接报错！

在我（以及很多手动升级的用户）的案例中，主要有两个“拦路虎”：

官方核心文件没有同步更新完全：execution.py还是旧的。
第三方插件搞事情：安装过ComfyUI-Queue-Manager插件，它接管了系统队列，但它的代码还没适配 v0.4.0。

解决方案（三步走）

如果你也遇到了这个问题，请按顺序执行以下操作。注意：这三个操作缺一不可！

第一步：确保 main.py 是最新的

既然要升级 v0.4.0，首先要确保启动脚本是最新的。

操作：从 ComfyUI 官方 GitHub 仓库下载最新的main.py覆盖根目录文件。
这一步通常是我们升级的开始，也是导致报错的诱因，但它是必须的。

第二步：同步更新 execution.py（核心修复）

很多时候我们只覆盖了main.py，却忘了它的“搭档”文件。

操作：从 ComfyUI 官方 GitHub 仓库下载最新的execution.py，替换ComfyUI根目录下的同名文件。
作用：确保 ComfyUI 原生的队列系统能听懂main.py发出的新指令。

第三步：移除不兼容的队列插件（关键修复）

这是最容易被忽视的一点。报错信息里的QM_Queue其实暴露了是Queue Manager插件在报错。

操作：进入custom_nodes文件夹，找到comfyui_queue_manager（或类似名字），将其删除或移出该目录。
作用：这个插件目前（截止2025年12月）尚未适配 v0.4.0 的 API。删除它，让 ComfyUI 回归使用官方原生的队列系统。

针对以上三步操作的疑问解惑：
“这三个操作（更新main.py、更新execution.py、删除Queue Manager插件），哪些是有效的？”

答案是：这是一个“组合拳”，其中两个是决定性的修复步骤，一个是必要的前提。

更新main.py：这是必要前提，也是诱因。是因为您更新了它（为了升级到 v0.4.0），它开始发送新指令（process_item），才暴露了后面两个旧文件/旧插件接不住招的问题。
更新execution.py：这是核心修复之一。如果不更新它，就算删了插件，ComfyUI 原生的队列也会因为接不住process_item而报错。
删除comfyui_queue_manager：这是关键修复之二。这个插件“劫持”了队列系统，但代码太老。如果不删它，就算您更新了所有官方文件，这个插件依然会挡在中间报错。