ModuleNotFoundError: No module named ‘comfy_aimdo.vram_buffer’

用户在 Windows 系统下首次打开 ComfyUI(通过 Comfy Desktop 启动),启动过程中 ComfyUI 自动下载 "image_z_image_turbo" 模板所需的模型文件(约19GB),下载完成后启动失败,抛出模块导入错误。

快速结论:该报错通常在 ComfyUI 启动时加载自定义节点或内置模板功能时触发,优先排查是否使用了非官方的 ComfyUI 桌面客户端(如 Comfy Desktop)或启用了尚处于实验阶段的 “templates” 功能,以及是否存在损坏或不兼容的自定义节点。

问题场景

用户在 Windows 系统下首次打开 ComfyUI(通过 Comfy Desktop 启动),启动过程中 ComfyUI 自动下载 “image_z_image_turbo” 模板所需的模型文件(约19GB),下载完成后启动失败,抛出模块导入错误。

报错原文

ModuleNotFoundError: No module named 'comfy_aimdo.vram_buffer'

原因分析

可能原因:ComfyUI 在加载 “templates” 或某些自定义节点(包括内置节点)时,尝试导入 comfy_aimdo.vram_buffer 模块,但该模块在当前环境中不存在或安装不完整。该模块可能属于某个自定义节点或 ComfyUI 的扩展组件,但由于依赖缺失、版本不匹配或安装路径错误导致 ImportError。Issue 中未提供完整的回溯栈,无法判断触发导入的具体组件。

环境排查

  • 确认 ComfyUI 版本(是否为最新版或最近更新的版本)。
  • 确认是否为 Comfy Desktop 客户端启动,而非标准的 python main.py
  • 检查 ComfyUI/custom_nodes/ 目录下是否存在可疑的自定义节点文件夹。
  • 检查 Python 版本(建议 3.10 或 3.11)。
  • 检查是否有其他报错提及 comfy_aimdo 相关模块。

解决步骤

  1. 禁用所有自定义节点:重命名 ComfyUI/custom_nodes/ 文件夹为 custom_nodes_disabled,然后重新启动 ComfyUI。如果问题消失,则逐个启用自定义节点,找出报错的节点。
  2. 如果问题依然存在:检查 ComfyUI 的 templates 功能是否导致模块导入错误。注意 Issue 中用户启动时带了 --feature-flag show_signin_button=true --feature-flag enable_telemetry=true --enable-manager 等参数,可能与实验性功能有关。
  3. 可优先尝试:删除或移动 ComfyUI/templates/ 目录(如果存在),然后重新启动 ComfyUI,看是否跳过模板加载并正常启动。
  4. 如果使用 Comfy Desktop 客户端:尝试切换到标准的 python main.py 启动方式,以排除客户端特有的问题。
  5. 如果上述步骤无效,参考 Issue #14766(可能为重复问题)中的解决方案。

验证方法

成功启动 ComfyUI 且启动日志中不再出现 ModuleNotFoundError: No module named 'comfy_aimdo.vram_buffer',能够正常加载工作流并生成图片。

参考来源

Comfy-Org/ComfyUI #14790 — 含 Issue 正文及自动检测到的可能重复 Issue #14766 链接。

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 16230

发表回复

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