ReActor / 换脸节点导入失败，facexlib 等依赖缺失或模型下载失败

ComfyUI-Reactor node IMPORT FAILED
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• 只 clone 了 ReActor 代码，依赖（insightface / onnxruntime / facexlib）没装齐
• inswapper_128.onnx 与 buffalo_l 等模型文件缺失、下载被墙或文件损坏
• 模型文件下载后未放入 ReActor 约定的 models 目录

根因

• ReActor 在 import 阶段就会检查依赖，任一缺失整包节点不注册，表现为节点直接消失（而不是弹报错框），facexlib 是常见漏装项
• ReActor 需要 inswapper_128.onnx 与 insightface 的人脸模型（buffalo_l）；社区明确记录过 inswapper_128.onnx 文件有问题时会报错，即模型文件本身损坏也会导致失败
• 依赖多来自 Hugging Face，国内直连经常下载中断，得到半截文件

解决步骤

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

1. 用便携版内置 Python 一次性装齐 ReActor 依赖
   进 ReActor 节点目录，用便携版解释器装它自己的 requirements（会带上 facexlib、onnxruntime 等）；insightface 若在 requirements 里失败，按本文件 insightface 编译失败条目单独处理（优先用匹配 Python 版本的预编译 wheel）。装完完全重启 ComfyUI。
   cd ComfyUI\custom_nodes\comfyui-reactor-node
   ..\..\python_embeded\python.exe -m pip install -r requirements.txt
   ..\..\python_embeded\python.exe -m pip install facexlib
2. 补装 insightface 与匹配的 onnxruntime
   ReActor 的核心是人脸识别与换脸，必须有 insightface；有 NVIDIA 显卡时用 onnxruntime-gpu 才有速度，但版本要与本机 CUDA/cuDNN 匹配，否则会报 Failed to create CUDAExecutionProvider 或 LoadLibrary failed with error 126。注意不要与 CPU 版 onnxruntime 同时安装。
   ..\..\python_embeded\python.exe -c "import onnxruntime; print(onnxruntime.get_available_providers())"
3. 手工下载模型文件并校验完整性
   inswapper_128.onnx 与人脸识别模型 buffalo_l 需从官方/可信镜像下载后放入 ReActor 约定的 models 目录（ReActor README 有明确目录说明）。下载后核对文件体积是否与发布页一致；社区记录过 inswapper_128.onnx 文件异常导致报错的情况，所以必须排除半截文件。国内下载困难时优先使用带哈希校验的镜像。
4. 重启后确认节点注册与依赖可用
   完全重启 ComfyUI，在节点搜索里搜 ReActor 应能出现；启动日志中该包不应再有 IMPORT FAILED。再用便携版解释器验证 facexlib / insightface 均可 import。
   ..\..\python_embeded\python.exe -c "import facexlib, insightface; print('ok')"

验证是否修好

补充说明

error_text 未在搜索结果中拿到 issue 正文逐字原文，取自社区问答文章标题 'ComfyUI-Reactor node IMPORT FAILED'，故 error_text_verbatim 标为 false。inswapper_128.onnx 文件异常会导致报错这一点来自 ReActor 仓库 README 俄文版说明片段（'Эта ошибка появляется, если что-то не так с файлом модели inswapper_128.onnx'，意为该错误出现在模型文件有问题时）。

来源

1. [252] （社区）　How do I fix "ComfyUI-Reactor node IMPORT FAILED" in ComfyUI?　https://forum.smartart.live/topic/352-how-do-i-fix-comfyui-reactor-node-import-failed-in-comfyui/
2. [242] （社区）　Installation and Setup | Gourieff/ComfyUI-ReActor　https://deepwiki.com/Gourieff/ComfyUI-ReActor/2-installation-and-setup
3. [253] （社区）　ComfyUI-Reactor README：inswapper_128.onnx 文件异常导致的报错说明　https://huggingface.co/spaces/V0pr0S/ComfyUI-Reactor-Fast-Face-Swap-CPU/commit/35ba0ec134f63079a0cbbe67bcae92a2dacff1e8
4. 本机实测专项（RTX 5060 Ti / cu128 环境）（2 条）

本条报错提到的节点仓库

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

这条报错要用到的东西

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

同一类别的其他条目

返回报错库