IPAdapter 模型找不到：统一加载器与手动加载器的命名规则不同
已下载 IPAdapter 权重，但统一加载器仍无法自动选择文件。首先检查所用加载器的规则；“文件在磁盘上”与“能够按预设自动找到”并不是一回事。
现象与适用范围
已下载 IPAdapter 权重，但统一加载器仍无法自动选择文件。改名或移动文件前，应先确认实际报错节点。
检索用原文或片段（具体编号、数值和文件名随环境变化）：
IPAdapter model not found.
IPAdapterUnifiedLoader
已核对的依据
作者 README 要求统一加载器使用说明中的文件名；旧版手动模型加载器则提供 ipadapter_file 下拉选择。固定版本源码的 get_ipadapter_file(preset, is_sdxl) 会读取已注册的 ipadapter 文件名，按预设和底模是否属于 SDXL 家族选匹配式。没有候选时统一加载器抛出 IPAdapter model not found.。它在此前会先查找、加载 CLIP Vision；视觉文件找不到有另一条错误。文件名匹配也不能证明内部权重兼容。作者 README 固定版本解析式 固定版本加载器
需要区分的情况
1. 当前实例的 ipadapter 列表没有候选文件，可能是路径未注册，或下载文件仍用通用名称。
2. 所选预设及 SD1.5/SDXL 底模家族对应另一文件名模式，或源码明确不支持这种组合。
3. 名称虽然匹配，但文件身份、内部权重、视觉编码器或所需 FaceID LoRA 不对，之后在加载或应用阶段失败。
建议的操作顺序
以下是依据源码编排的诊断流程，并非对你的机器已有诊断结果。
第 1 步。 记录准确节点类、异常文本、预设和底模家族。分别识别 ClipVision model not found.、IPAdapter model not found.、LoRA model not found. 以及后续加载/维度错误。
第 2 步。 查看运行中服务端已注册的 ipadapter 文件名和模型路径。对照已安装的 get_ipadapter_file 预设模式及发布方文件身份；不要为了匹配名称而把无关权重改名。
第 3 步。 需要时单独核对 clip_vision 和 loras 类别。若多个文件名均匹配，确认已安装解析器实际先选哪个。
第 4 步。 在工作流副本中用一张参考图，测试发布方支持的适配器、视觉编码器和底模组合。手动 IPAdapterModelLoader 可以显式选择文件，但配套关系仍须由工作流作者保证。
如何判断处理有效
运行实例能选择并加载目标文件，配套的最小工作流能进入采样；仅文件名匹配还不算解决。
注意事项与尚未确认的部分
作者将仓库标记为 maintenance-only。固定版本源码只描述该版本实现；实际操作前要核对已安装节点行为。作者链接不代表本站已下载或校验权重。
原始资料
- IPAdapter Plus README。核对：2026-09-26。
- 固定版本 IPAdapter 文件解析式。核对：2026-09-26。
- 固定版本统一和手动加载器。核对：2026-09-26。
资料及中文语言审查：2026-09-26。本站未下载、加载或运行模型，也没有 GPU 测试或兼容保证。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- CLIP Vision 找不到或不兼容：它不是提示词用的文本 CLIP
ClipVision model not found.参考图工作流缺少视觉编码器，或加载后在图像嵌入阶段出现维度不匹配。先确认需要的是 CLIP Vision，而不是 CLIPTextEncode 对应的文本编码器。 - FaceID 的 InsightFace 安装失败：分开检查 Python 依赖与模型资源
No module named 'insightface'使用 FaceID 时出现 insightface 模块缺失、构建 wheel 失败，或者包安装后仍无法初始化。这里需要分别确认解释器、二进制构建、运行后端与模型资源。
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
2026-09-26 复核作者 README、固定版本 a0f451a 的 IPAdapter 文件解析、统一和手动加载器及中文措辞。本站未下载模型、执行工作流或 GPU 测试。
01IPAdapter Plus README资料核对: 2026-09-2602Pinned IPAdapter filename resolver资料核对: 2026-09-2603Pinned unified and manual loaders资料核对: 2026-09-26报告问题 · aea57e1a-9e1b-5692-a8d8-0e68b6dd8119
相关阅读
编辑为本页关联的条目。
固定版本源码表明 IPAdapterUnifiedLoader 用 MODEL 和预设加载资源，输出 MODEL 与 IPADAPTER；参考图片接在后续应用节点。