Error occurred when executing InstantIDFaceAnalysis:

快速结论：此报错通常在使用 ComfyUI InstantID 节点加载 InsightFace 模型时触发，优先排查模型文件放置路径是否正确，最常见原因是 antelopev2.zip 未解压或解压后产生了嵌套目录（如 antelopev2/antelopev2/）。

问题场景

用户在使用 ComfyUI 搭配 InstantID 自定义节点进行面部分析（InstantIDFaceAnalysis）时，在执行流中触发 AssertionError，导致节点执行中断。该报错出现在 InsightFace 的 FaceAnalysis 初始化阶段。

报错原文

File "D:\Stable_Diffusion\ComfyUI_windows_portable_nightly_pytorch\ComfyUI\custom_nodes\ComfyUI_InstantID\InstantID.py", line 359, in load_insight_face
    model = FaceAnalysis(name="antelopev2", root=INSIGHTFACE_DIR, providers=[provider + 'ExecutionProvider',])
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "python_embeded\Lib\site-packages\insightface\app\face_analysis.py", line 43, in __init__
    assert 'detection' in self.models
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
AssertionError

原因分析

根据 Issue 讨论，核心原因是 InsightFace 模型文件未能被正确加载。FaceAnalysis 在初始化时检查 self.models 字典是否包含 'detection' 键，若模型文件缺失或路径错误，则无法检测到该条目，触发 AssertionError。实际测试表明，模型文件夹结构不正确（如解压后产生 antelopev2/antelopev2/ 嵌套目录）或未解压 antelopev2.zip 是最常见的触发因素。

环境排查

确认 ComfyUI 版本及 InstantID 自定义节点版本（来自 ComfyUI_InstantID 仓库）。
确认 InsightFace 依赖已安装（Python 包 insightface）。
确认模型文件已下载并放置在正确路径：ComfyUI/models/insightface/models/antelopev2/
确认 antelopev2.zip 已解压，且解压后的文件直接位于 antelopev2/ 文件夹内，无额外嵌套目录。
检查控制台完整回溯日志（backtrace）以确认具体加载路径。

解决步骤

下载 antelopev2.zip 模型包（可从 Hugging Face 或其他镜像获取）。
将 antelopev2.zip 解压到 ComfyUI/models/insightface/models/antelopev2/ 目录下。可优先尝试创建 insightface/models 目录结构（若不存在）。
确保解压后的文件（如 .onnx 文件）直接位于 antelopev2/ 内，而不是 antelopev2/antelopev2/... 这样的嵌套结构。例如正确路径应为：models/insightface/models/antelopev2/1k3d68.onnx。
重启 ComfyUI，重新加载工作流并触发 InstantIDFaceAnalysis 节点。

验证方法

重新运行原工作流，查看终端/命令行输出是否正常加载模型文件（如显示 find model: ... antelopev2\1k3d68.onnx），且不再出现 AssertionError。同时，InstantIDFaceAnalysis 节点应能成功执行，不弹出错误弹窗。

参考来源

cubiq/ComfyUI_IPAdapter_plus #263

AI 工具推荐

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

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

了解 GamsGo AI

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

Error occurred when executing InstantIDFaceAnalysis: