快速结论:这个报错通常发生在 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、显卡型号等版本信息,遇到问题时不必优先怀疑这些环境,除非另有报错。
解决步骤
- 按照 IPAdapter Plus 作者说明,下载所需的 CLIP Vision 模型文件。
- 将下载好的模型放入 ComfyUI 的
clip_vision模型文件夹中,确保路径与节点加载路径一致。 - 完全重启 ComfyUI,再次运行 IPAdapterUnifiedLoader 节点,观察报错是否消失。
- 如果仍然报
ClipVision model not found,检查clip_vision文件夹中的文件名。 - 按 Issue 作者给出的方式重命名文件:将
CLIP-ViT-bigG-14-laion2B-39B-b160k重命名为CLIP-ViT-bigG-14-laion2B-39B.b160k。 - 将
CLIP-ViT-H-14-laion2B-s32B-b79K重命名为CLIP-ViT-H-14-laion2B-s32B.b79K。 - 再次完全重启 ComfyUI,然后重新运行工作流。
验证方法
重启 ComfyUI 后,重新执行 IPAdapterUnifiedLoader 节点。如果不再出现 ClipVision model not found,并且后续 IPAdapter 节点能够正常加载和执行,说明问题已解决。若仍然报错,说明当前模型文件仍未被节点识别,需要继续检查模型是否放错目录、文件名是否仍不匹配,或是否存在节点安装不完整等其他因素。
参考来源
cubiq/ComfyUI_IPAdapter_plus #677
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


