IPAdapter Plus：IPAdapter model not found（模型文件或目录放错）

IPAdapter model not found.

现象与触发场景

常见触发场景：

• 只装了节点没下 IPAdapter 模型文件，或模型放错目录
• 把模型放进了 models/ipadapter 之外的目录（比如塞进 loras 或 models/clip_vision）
• 选了 UnifiedLoader 但对应的 clip vision 模型不存在，于是抛出 KeyError: 'clipvision'
• 新版 IPAdapter 与旧工作流的节点不兼容（旧节点已改名/移除）

根因

• IPAdapter 节点读取固定目录 models/ipadapter（另有 models/clip_vision 用于 CLIP Vision 编码器），文件名与节点内部列表必须匹配；文件不在该目录或命名不符，就找不到模型
• UnifiedLoader 会自动去找配套的 clip vision，找不到时不是报「文件缺失」而是抛 KeyError: 'clipvision'，容易被误判成代码 bug
• 新版 IPAdapter plus 重构过节点名，旧工作流里的老节点名在新版里已不存在，表现是节点缺失/报错

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 把 IPAdapter 模型与 CLIP Vision 模型放对目录
   IPAdapter 权重（.bin/.safetensors，如 ip-adapter-plus_sd15 系列）放进 ComfyUI/models/ipadapter；CLIP Vision 编码器（如 CLIP-ViT-H-14-laion2B-s32B-b79K 的 model.safetensors 或 clip-vit-large）放进 ComfyUI/models/clip_vision。放完完全重启 ComfyUI，节点下拉框才能刷新出来。IPAdapter 节点文档对 FaceID 等特殊组合还要求额外的 insightface 人脸模型。
2. 按报错关键字区分两类失败：model not found 与 KeyError 'clipvision'
   报 IPAdapter model not found 说明是 IPAdapter 权重没找到（查 models/ipadapter）；报 KeyError: 'clipvision' 说明权重找到了但配套的 CLIP Vision 缺失（查 models/clip_vision）。社区已记录该 KeyError 的明确解法就是补齐 clip vision 模型。先分清是哪一类再补文件，能省很多时间。
3. 确认节点版本与工作流版本匹配
   新版 IPAdapter plus 不再兼容旧版节点（旧工作流里已被移除的节点会加载不了）。要么把节点更新到最新并手工替换工作流里被重命名的节点，要么把节点回退到与工作流同期版本。中文社区有专门说明这一点的文章，遇到「节点没了/名字变了」时先查版本对应关系。
   cd ComfyUI\custom_nodes\ComfyUI_IPAdapter_plus
   git log --oneline -5
4. FaceID 路线额外确认 insightface 与人脸模型就位
   使用 IPAdapter FaceID / UnifiedLoaderFaceID 时，除 IPAdapter 与 clip vision 外还需 insightface 与对应人脸识别模型（buffalo_l 等）。insightface 装不上见本文件 insightface 编译失败条目；模型需放到 insightface 约定的 models 目录下。

验证是否修好

补充说明

error_text 取自 cubiq/ComfyUI_IPAdapter_plus issue #611 标题原文。KeyError: 'clipvision' 来自 issue #627 标题 'IPAdapter Unified Loader throw KeyError: 'clipvision' and my solution'。FaceID 缺模型的完整报错形态见 runcomfy 指南标题（Error occurred when executing IPAdapterUnifiedLoaderFaceID: IPAdapter model not found）。

来源

1. [246] （节点仓库 issue）　IPAdapter model not found.　https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/611
2. [104] （节点仓库 issue）　IPAdapter Unified Loader throw KeyError: 'clipvision' and my solution　https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/627
3. [247] （社区）　How to fix: Error occurred when executing IPAdapterUnifiedLoaderFaceID　https://comfyui-guides.runcomfy.com/ultimate-comfyui-how-tos-a-runcomfy-guide/how-to-fix-error-occurred-when-executing-ipadapterunifiedloaderfaceid-ipadapter-model-not-found
4. [248] （中文社区）　新版 ComfyUI IPAdapter plus 不再兼容旧版节点　http://www.a-hxin.cn/archives/1141/

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

这条报错要用到的东西

按本条报错所属的类别（热门自定义节点/工作流专有报错）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库