快速结论:当在 ComfyUI 中使用 IPAdapterUnifiedLoader 节点加载 IPAdapter 模型时,如果工作流中残留了旧版本的 IPAdapter 节点或适配器,就会触发 “IPAdapter model not found.”。通常优先排查并替换工作流中的旧 IPAdapter 节点。
适用环境:Windows 系统,ComfyUI 便携版(nvidia_cu121_or_cpu),Python/CUDA/PyTorch 具体版本 Issue 中未明确。
最快修复方案:删除工作流中原有的 IPAdapterUnifiedLoader 节点,重新插入一个新的 IPAdapterUnifiedLoader 节点并重新连接,然后执行。
注意事项:重新插入节点后需确保所有参数(尤其是图像比例相关参数)匹配,否则可能仍然失败;旧节点的“过时”状态在 UI 上可能无法直接识别,因此只能通过替换节点来验证。
问题场景
用户在 ComfyUI 中运行包含 IPAdapterUnifiedLoader 节点的工作流时,该节点抛出异常,导致工作流无法执行。用户提到“It works with Ipadapter model load but does not with ipadapter unified loader”,即单独使用 IPAdapter 模型加载节点可以工作,但 UnifiedLoader 节点不行。后续用户发现,仅在使用 juggernautXL 作为 checkpoint 时触发此问题。
报错原文
Node Type: IPAdapterUnifiedLoader
Exception Type: Exception
Exception Message: IPAdapter model not found.
File "...\ComfyUI\custom_nodes\ComfyUI_IPAdapter_plus\IPAdapterPlus.py", line 573, in load_models
raise Exception("IPAdapter model not found.")
原因分析
根据 Issue 讨论,最可能的原因是在之前的工作流中使用了旧版本(已弃用)的 IPAdapter 适配器,而该旧适配器在 UI 中不可见或无法直接识别为“过时”。当加载包含旧 IPAdapterUnifiedLoader 节点的工作流时,该节点无法找到匹配的新模型,从而抛出 “IPAdapter model not found.”。用户最终通过删除旧节点、重新创建 IPAdapterUnifiedLoader 解决了问题,因此可以确认旧节点或旧适配器残留在工作流中是根本原因。
环境排查
- 确认 ComfyUI 便携版路径是否正确,是否使用了 nvidia_cu121_or_cpu 版本。
- 确认 ComfyUI_IPAdapter_plus 自定义节点已正确安装并更新至最新版本。
- 确认使用的 checkpoint 模型(如 juggernautXL)是否与 IPAdapter 适配器兼容;Issue 中未给出具体版本号。
- 检查工作流中是否存在多个 IPAdapterUnifiedLoader 节点或已失效的旧节点。
- 确认输入图像尺寸与计算尺寸是否匹配(用户提到图像比例不匹配也可能导致适配器锁定)。
解决步骤
- 打开出问题的工作流,定位到 IPAdapterUnifiedLoader 节点。
- 删除该节点(以及可能与之关联的旧适配器节点)。
- 从节点菜单中重新添加一个新的 IPAdapterUnifiedLoader 节点。
- 重新连接所有输入和输出链路,确保参数与之前一致。
- 执行工作流,观察是否仍然报错。
- 若问题依旧,检查输入图像尺寸与计算尺寸是否匹配,调整参数使两者一致。
验证方法
重新执行工作流后,IPAdapterUnifiedLoader 节点不再抛出 “IPAdapter model not found.” 异常,且能正常加载模型并输出结果,即表示问题已解决。
参考来源
cubiq/ComfyUI_IPAdapter_plus #708
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


