
I have fixed the error: Error occurred when executing IPAdapterUnifiedLoader: ClipVision model not found.
快速结论:该报错通常出现在 ComfyUI 的 IPAdapterUnifiedLoader 节点执行时,原因是 CLIP Vision 模型未正确放置在指定目录或文件名不符合节点解析规则。优先排查 ComfyUI/models/clip_vision 文件夹下的模型文件名是否与预期一致。
问题场景
用户在使用 ComfyUI 的 IPAdapter Plus 节点(IPAdapterUnifiedLoader)时触发报错,通常发生在加载 IPAdapter 流程中,节点依赖 CLIP Vision 模型进行图像编码。
报错原文
Error occurred when executing IPAdapterUnifiedLoader: ClipVision model not found.
原因分析
可能的原因是该报错由 CLIP Vision 模型文件未被正确识别导致。根据 Issue 中用户的修复经验,主要原因有两个:
- 模型缺失:未下载对应的
CLIP-ViT-bigG-14-laion2B-39B-b160k或CLIP-ViT-H-14-laion2B-s32B-b79K模型文件到ComfyUI/models/clip_vision目录。 - 文件名格式错误:下载后的文件名中带有连字符(如
CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensors),但节点解析时可能将-误识别为分隔符,导致找不到模型。需按特定格式重命名(如将-改为.或调整位置)。
注意:该修复方案来自用户个人经验,并非官方确认的解决方案。如果重命名后无效,可能还有其他原因(如模型版本不匹配)。
环境排查
- 确认 ComfyUI 已正确安装 ComfyUI_IPAdapter_plus 节点(版本与 Issue 对应)。
- 检查
ComfyUI/models/clip_vision/目录下是否存在以下文件: CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensorsCLIP-ViT-H-14-laion2B-s32B-b79K.safetensors- 如果文件存在,检查文件名中是否包含连续连字符(如
CLIP-ViT-bigG-14-laion2B-39B-b160k)。 - 确认 ComfyUI 和节点是否均已重启(重启后生效)。
解决步骤
- 下载缺失的 CLIP Vision 模型:
- 从节点作者的官方说明中获取模型下载链接(Issue 中未提供直接链接,请参照 IPAdapter Plus 的 README)。
- 将下载的
.safetensors文件放入ComfyUI/models/clip_vision/文件夹。
- 重命名模型文件(可优先尝试):
- 将
CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensors重命名为CLIP-ViT-bigG-14-laion2B-39B.b160k.safetensors - 将
CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors重命名为CLIP-ViT-H-14-laion2B-s32B.b79K.safetensors - 说明:原文件名中的
-b160k和-b79K部分被改为.b160k和.b79K,避免连字符导致的解析问题。
- 将
- 重启 ComfyUI:完全关闭 ComfyUI 程序并重新启动,确保节点重新加载模型列表。
验证方法
在 ComfyUI 中重新加载工作流,执行 IPAdapterUnifiedLoader 节点,如果不再弹出 “ClipVision model not found” 错误,并且节点正常输出模型信息,则代表问题解决。



