IpAdapterUnifiedLoader > IpAdapter model not found >> old IpAdapter not visible in UI

快速结论：该报错通常发生在使用旧工作流时，工作流中的 IPAdapterUnifiedLoader 节点是旧版本的“遗留”节点，虽然表面上看起来正常，但其内部配置与新版本不兼容，导致模型加载失败。优先排查方式：**新建一个 IPAdapterUnifiedLoader 节点替换旧节点**。

问题场景

用户在使用 ComfyUI 的 IPAdapter Plus 自定义节点 (cubiq/ComfyUI_IPAdapter_plus) 时触发。在加载旧的工作流（尤其是包含之前版本创建的 IPAdapterUnifiedLoader 节点）时，节点报错 IPAdapter model not found。值得注意的是，报告者提到在更换检查点（如使用 juggernautXL）时更容易复现此问题，但根本原因不在此。

报错原文

# ComfyUI Error Report
## Error Details
- **Node Type:** IPAdapterUnifiedLoader
- **Exception Type:** Exception
- **Exception Message:** IPAdapter model not found.
## Stack Trace
  File "...\ComfyUI\custom_nodes\ComfyUI_IPAdapter_plus\IPAdapterPlus.py", line 573, in load_models
    raise Exception("IPAdapter model not found.")

原因分析

可能原因：这是一个由“旧版适配器节点”引发的问题。用户之前用旧版本插件创建的工作流中包含了“旧”的、已经废弃的“遗留”节点。在插件升级后，这些旧节点虽然在UI中可见，但在内部逻辑上已经与新版本不兼容。当它们被加载时，无法正确找到或加载IPAdapter模型，从而抛出 IPAdapter model not found 错误。特别地，这些旧节点在用户界面中可能没有任何“过时”、“已弃用”的视觉标识，非常隐蔽。

环境排查

ComfyUI 版本：需要确认是否在近期更新了 ComfyUI 或 ComfyUI_IPAdapter_plus 插件。
IPAdapter Plus 插件版本：确认是否为最新版本（该 Issue 关闭于 2024-09-08）。
工作流来源：确认当前使用的 workflow（.json文件）是否为较早期创建，特别是其中包含 IPAdapterUnifiedLoader 节点。

解决步骤

删除旧节点：在 ComfyUI 工作区中，找到并删除报错的 IPAdapterUnifiedLoader 节点。
新建节点：右键点击空白处，通过菜单查找并添加一个新的 IPAdapterUnifiedLoader 节点（这步最简单，也是最有可能解决的方法）。
重新连接：将新节点的输入和输出，按照原工作流的逻辑重新进行连线。
（可优先尝试）替代方案：如果上述方法不生效，可以尝试利用社区提供的“兼容性”节点，例如 Reddit 上提到的“维持旧版IPAdapter节点与新版共存”的方法，安装或启用旧版节点支持。但报告者提到“没有理解该如何操作”，故此法稳定性存疑。
检查检查点：虽然根本原因不在此，但 Issue 中报错在使用 juggernautXL 检查点时更频繁。如果无法解决，可以尝试更换一个标准的 Stable Diffusion XL 检查点进行测试，以排除模型特定问题。

验证方法

完成以上步骤后，点击 ComfyUI 中的 “Queue Prompt” 运行工作流。如果控制台不再弹出 IPAdapter model not found 错误，且图片正常生成，则说明问题已解决。

参考来源

cubiq/ComfyUI_IPAdapter_plus #708

AI 工具推荐

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

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

了解 GamsGo AI

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

IpAdapterUnifiedLoader > IpAdapter model not found >> old IpAdapter not visible in UI