I have fixed the error: Error occurred when executing IPAdapterUnifiedLoader: ClipVision model not found.

这个报错通常发生在 ComfyUI 使用 IPAdapter Plus 的 IPAdapterUnifiedLoader 节点时,ComfyUI 在 clip_vision 目录下找不到名称匹配的 CLIP Vision 模型文件,优先检查模型是否已放入正确目录且文件名是否与节点预期一致。

快速结论:这个报错通常发生在 ComfyUI 使用 IPAdapter Plus 的 IPAdapterUnifiedLoader 节点时,ComfyUI 在 clip_vision 目录下找不到名称匹配的 CLIP Vision 模型文件,优先检查模型是否已放入正确目录且文件名是否与节点预期一致。

适用环境:Issue 中未提供明确的操作系统、Python、CUDA、PyTorch 或显卡版本信息,仅确认使用 ComfyUI 与 IPAdapter Plus 节点,并涉及 clip_vision 文件夹中的模型文件。

最快修复方案:按作者说明下载所需的 CLIP Vision 模型并放入对应目录;若重启 ComfyUI 后仍报同样错误,将 clip_vision 文件夹内的文件名按 Issue 中给出的方式重命名,然后重启 ComfyUI。

注意事项:文件名重命名方案来自 Issue 作者与 Reddit 成员的分享,属于社区经验,并非所有环境都验证有效;有评论反馈重装节点并尝试相同方法后问题仍未解决。重命名前建议先备份原文件,避免后续其他节点或工作流因名称变化无法识别模型。

问题场景

用户在 ComfyUI 中运行 IPAdapter Plus,使用 IPAdapterUnifiedLoader 节点加载 IPAdapter 相关模型时触发报错。该节点需要自动匹配 CLIP Vision 模型,因此当 ComfyUI 在 clip_vision 目录中找不到节点期望的模型文件或文件名不匹配时,就会在执行阶段中断。

报错原文

I have fixed the error: Error occurred when executing IPAdapterUnifiedLoader: ClipVision model not found.

原因分析

最可能的原因是缺少 IPAdapter Plus 所需的 CLIP Vision 模型文件,或者模型文件虽然已下载,但实际文件名与节点查找时使用的名称不一致。Issue 作者指出,在完成模型下载并放入对应目录后,如果仍然看到同样的报错,通常是因为 clip_vision 文件夹内的文件名带有额外后缀或大小写、连字符差异,导致节点无法匹配。由于 Issue 中没有仓库维护者的官方确认,文件名不匹配这一原因应视为社区经验总结,而非已被上游代码明确验证的结论。

环境排查

  • 确认 ComfyUI 已安装并可正常启动,IPAdapter Plus 节点已正确安装。
  • 确认 ComfyUI 的模型目录结构完整,尤其是 models/clip_vision 文件夹存在。
  • 确认 clip_vision 目录中已放入 IPAdapter Plus 所需的 CLIP Vision 模型文件。
  • 核对文件名是否与 Issue 中所述节点预期名称一致,注意连字符、点号、大小写等细节。
  • 确认修改模型文件名或新增模型后已完全重启 ComfyUI,而不是只刷新页面。
  • Issue 未提供 Python、CUDA、PyTorch、显卡型号等版本信息,遇到问题时不必优先怀疑这些环境,除非另有报错。

解决步骤

  1. 按照 IPAdapter Plus 作者说明,下载所需的 CLIP Vision 模型文件。
  2. 将下载好的模型放入 ComfyUI 的 clip_vision 模型文件夹中,确保路径与节点加载路径一致。
  3. 完全重启 ComfyUI,再次运行 IPAdapterUnifiedLoader 节点,观察报错是否消失。
  4. 如果仍然报 ClipVision model not found,检查 clip_vision 文件夹中的文件名。
  5. 按 Issue 作者给出的方式重命名文件:将 CLIP-ViT-bigG-14-laion2B-39B-b160k 重命名为 CLIP-ViT-bigG-14-laion2B-39B.b160k。
  6. 将 CLIP-ViT-H-14-laion2B-s32B-b79K 重命名为 CLIP-ViT-H-14-laion2B-s32B.b79K。
  7. 再次完全重启 ComfyUI,然后重新运行工作流。

验证方法

重启 ComfyUI 后,重新执行 IPAdapterUnifiedLoader 节点。如果不再出现 ClipVision model not found,并且后续 IPAdapter 节点能够正常加载和执行,说明问题已解决。若仍然报错,说明当前模型文件仍未被节点识别,需要继续检查模型是否放错目录、文件名是否仍不匹配,或是否存在节点安装不完整等其他因素。

参考来源

cubiq/ComfyUI_IPAdapter_plus #677

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 25754

发表回复

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