快速结论:在 ComfyUI Manager 中安装模型时,用户只看到 Exception: ('install-model', ...),没有得到具体的失败原因,安装实际上已经中断。这个问题常见于旧版 Manager 的错误处理缺陷。调试时,应以终端日志为准,不必依赖弹窗报错。
适用环境:Issue 中确认的工具是 ComfyUI Manager,触发安装的是 4x-UltraSharp 等模型;未提供操作系统、Python、CUDA、PyTorch、显卡等环境信息。
最快修复方案:暂无确认的一步修复方案。针对该弹窗信息丢失的问题,相关修复已于 2025-07-07 合入 #1977。可优先尝试升级到包含该修复的 ComfyUI Manager 版本,然后重新安装,并查看终端日志中的实际错误。
注意事项:该 Issue 因缺少完整日志被关闭,因此当初导致下载失败的原因无法确定;升级后只解决了“看不到真实报错”的问题,并不能保证所有模型的下载失败都会随之消失。如果仍失败,需要根据终端中新的错误信息继续排查。
问题场景
用户在 ComfyUI 中通过 Manager 安装模型,先尝试安装 4x-UltraSharp 放大模型,随后再尝试安装其他模型,均出现同样的安装失败弹窗,导致无法通过 Manager 完成模型安装。
报错原文
Installation Error:
Exception: ('install-model', ('e4538fa8158393184063fab4d7acddb7', {'base': 'upscale', 'description': '4x-UltraSharp upscaler model', 'filename': '4x-UltraSharp.pth', 'name': '4x-UltraSharp', 'reference': 'https://huggingface.co/Kim2091/UltraSharp/', 'save_path': 'default', 'size': '67.0MB', 'type': 'upscale', 'url': 'https://huggingface.co/Kim2091/UltraSharp/resolve/main/4x-UltraSharp.pth', 'installed': 'False', 'ui_id': 'e4538fa8158393184063fab4d7acddb7'}))
原因分析
根据 Issue 讨论,当时的问题在于:模型安装失败时,错误处理逻辑中的日志调用本身又抛出了异常,导致弹窗只显示 Exception: ('install-model', ...),真正的下载或写入失败原因被覆盖。也就是说,这是一个错误处理缺陷,会隐藏真实原因;它并不直接证明模型源本身不可用。后来版本在安装失败时会把实际错误写入终端日志,并在弹窗中显示 Model installation error: <url>。由于原始 Issue 未提供完整日志,最初下载失败的具体原因无法确认。
环境排查
- 确认 ComfyUI Manager 版本是否包含 2025-07-07 合入的 #1977 修复。
- 确认模型下载源 URL 是否可访问(Issue 中为 Hugging Face 链接),以及网络是否能正常访问该来源。
- 确认 ComfyUI 模型保存目录存在且具备写入权限。
- 安装失败时,保留终端完整日志,因为旧版弹窗信息不足以定位原因。
- Issue 未提供 Python、CUDA、PyTorch、显卡等版本信息,这些项目不作为本次结论依据。
解决步骤
- 升级 ComfyUI Manager 到包含 #1977 修复的版本,使安装失败时能够输出真实错误。
- 重启 ComfyUI,重新通过 Manager 安装目标模型。
- 打开 ComfyUI 所在终端,记录安装过程中的完整日志;当前版本应显示
Model installation error: <url>,并在终端中给出实际失败原因。 - 根据终端日志中的新错误继续排查,例如网络访问、下载源、保存路径或权限问题;不要继续依赖旧版
Exception: ('install-model', ...)弹窗判断根因。 - 如果升级后仍无法安装,整理终端日志并新建 Issue 反馈。
验证方法
重新安装模型后,检查终端日志:如果失败,应能看到具体的 Model installation error 及实际原因;如果安装成功,目标模型文件应出现在对应的模型目录中,并可被 ComfyUI 识别使用。
参考来源
ltdrdata/ComfyUI-Manager #1715
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


