RuntimeError: Added route will never be executed, method HEAD is already registered

该报错通常发生在 ComfyUI 启动加载 Impact Pack 时,两条信息往往对应两个独立问题:一是旧版 Impact Pack 读取 impact-pack.ini 缺少 default 段,二是 /impact/get_items 等路由被重复注册。优先排查 custom_nodes 下是

快速结论:该报错通常发生在 ComfyUI 启动加载 Impact Pack 时,两条信息往往对应两个独立问题:一是旧版 Impact Pack 读取 impact-pack.ini 缺少 default 段,二是 /impact/get_items 等路由被重复注册。优先排查 custom_nodes 下是否存在两份 Impact Pack,并把保留的那份更新到较新版本。

适用环境:Issue 中出现的环境为 Linux 路径部署的 ComfyUI,Python 3.12(miniconda 环境 comfyui),依赖 aiohttp,日志中出现 PyTorch CUDA 分配器告警;Issue 未明确确认 CUDA、显卡型号与具体 PyTorch 版本。

最快修复方案:Issue 中报告者确认“新的版本已经解决了这个问题”。按讨论中的处理思路,先检查 custom_nodes 是否同时存在 ComfyUI-Impact-Pack 与 comfyui-impact-pack 两份目录,删除其中一份,再把保留的目录更新到最新版本。

注意事项:讨论中的证据显示 9.0.1 已修复 impact-pack.ini 读取问题,日志中的行号对应 8.29;但“删除重复目录 + 更新版本”是针对路由重复注册问题的排查结论,报告者未给出逐步操作记录,可优先尝试。comfyui-impact-subpack 是另一个包,不属于重复目录。

问题场景

用户在更新 ComfyUI Impact Pack 后启动 ComfyUI,启动过程在注册 API 路由阶段失败。日志同时出现 [Impact Pack] 无法读取 impact-pack.ini(KeyError: ‘default’)以及 aiohttp 注册 HEAD 路由时报错,并指出冲突路由为 /api/impact/get_items,对应 ComfyUI-Impact-Pack/modules/impact/wildcard_source.py 中的 @PromptServer.instance.routes.get(“/impact/get_items”)。

报错原文

[ERROR] [Impact Pack] Failed to read impact-pack.ini — using hardcoded defaults
KeyError: 'default'
RuntimeError: Added route will never be executed, method HEAD is already registered
路由: /api/impact/get_items
文件: ComfyUI-Impact-Pack/modules/impact/wildcard_source.py:195
装饰器: @PromptServer.instance.routes.get("/impact/get_items")
错误: method HEAD is already registered

原因分析

讨论将日志拆为两个问题:

  • impact-pack.ini 读取失败:读取配置时找不到 default 段,抛出 KeyError: ‘default’。维护者说明这是 #1253,已在 9.0.1 修复,并指出用户日志中的行号对应 8.29。
  • HEAD 路由重复注册:维护者用单份 Impact Pack 在 ComfyUI 0.46.0 上分别测试 8.29 与 9.3,均能正常启动,因此未能复现该报错;但当 custom_nodes 下同时存在 ComfyUI-Impact-Pack 和 comfyui-impact-pack 两份目录时,可稳定复现同一错误。可能原因是两份包各自注册相同路由,ComfyUI/aiohttp 拒绝启动。

环境排查

  • 确认 custom_nodes 下 Impact Pack 的目录数量与名称,例如执行 ls /root/ComfyUI/custom_nodes | grep -i impact;注意 comfyui-impact-subpack 是独立的包,不算重复。
  • 确认启动日志中 “### Loading: ComfyUI-Impact-Pack” 出现次数。若出现两次,说明同一包被加载两次。
  • 确认 Impact Pack 版本:日志行号对应 8.29,且 9.0.1 起已修复 impact-pack.ini 的 default 缺失问题。
  • 记录 ComfyUI 版本(讨论中测试环境为 ComfyUI 0.46.0)与 Python 3.12,便于对照复现条件。

解决步骤

  1. 执行 ls /root/ComfyUI/custom_nodes | grep -i impact,检查是否存在两个 Impact Pack 目录(例如 ComfyUI-Impact-Pack 与 comfyui-impact-pack 大小写或命名不同的副本)。
  2. 在启动日志中统计 “### Loading: ComfyUI-Impact-Pack” 的出现次数,确认是否被重复加载。
  3. 若确认存在两份副本,删除其中一份,仅保留一个 Impact Pack 目录。
  4. 将保留的 Impact Pack 更新到最新版本,以一并消除旧版 impact-pack.ini 读取问题(9.0.1 已修复)。
  5. 重启 ComfyUI,观察启动日志。

验证方法

重启后日志中 “### Loading: ComfyUI-Impact-Pack” 只出现一次,不再出现 RuntimeError: Added route will never be executed, method HEAD is already registered,也不再出现 Failed to read impact-pack.ini,且 ComfyUI 能正常启动并加载 /api/impact/get_items 路由。Issue 报告者已确认新版本解决该问题。

参考来源

ltdrdata/ComfyUI-Impact-Pack #1289

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36725

发表回复

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