当前位置：首页 > news >正文

【笔记】解决 ComfyUI 安装 comfy-mtb 节点后 “Face restoration models not found.” 报错

news 2025/11/2 7:15:27

【实操笔记】解决 ComfyUI 安装 comfy-mtb 后 “Face restoration models not found.” 报错

https://github.com/melMass/comfy_mtb/blob/main/INSTALL.md

相关问题讨论

问题场景

安装 comfy-mtb 节点后，启动 ComfyUI 时出现警告：WARNING -> Face restoration models not found.，面部修复功能无法使用。查官方文档后，确认是缺少面部修复模型（如 GFPGAN），需手动下载。

[H:\PythonProjects1\Win_ComfyUI\custom_nodes\comfy-mtb] | WARNING -> Face restoration models not found.

实操步骤

1. 进入 ComfyUI 目录并激活虚拟环境

打开终端，先进入自己的 ComfyUI 安装目录，再激活对应的虚拟环境（我的环境名是 Win_ComfyUI）：

# 进入 ComfyUI 根目录
H:\> cd PythonProjects1\Win_ComfyUI# 激活虚拟环境（Windows 系统）
(Win_ComfyUI) H:\PythonProjects1\Win_ComfyUI> .venv\Scripts\activate

激活后终端提示符会显示类似 (Win_ComfyUI)，表示环境生效。

2. 进入 comfy-mtb 节点目录

comfy-mtb 节点默认安装在 custom_nodes 文件夹下，进入该目录：

(Win_ComfyUI) H:\PythonProjects1\Win_ComfyUI> cd custom_nodes\comfy-mtb

此时终端路径应为：H:\PythonProjects1\Win_ComfyUI\custom_nodes\comfy-mtb

在这里插入图片描述

3. 运行模型下载脚本

comfy-mtb 自带 download_models.py 脚本，专门用于下载缺失的模型。用虚拟环境的 Python 运行脚本：

(Win_ComfyUI) H:\PythonProjects1\Win_ComfyUI\custom_nodes\comfy-mtb> H:\PythonProjects1\Win_ComfyUI\.venv\Scripts\python.exe scripts/download_models.py

在这里插入图片描述

4. 选择需要下载的模型（关键步骤）

运行脚本后，会先检测已安装的模型，再列出可下载选项。我的终端显示：

Checkpoint 'inswapper_128.onnx' for Face Swap already exists in 'H:\PythonProjects1\Win_ComfyUI\models\insightface'
Choose models to download:
1. DeepBump
2. Face Swap
3. GFPGAN (face enhancement)
4. FILM: Frame Interpolation for Large Motion
Enter the numbers of the models you want to download (comma-separated):
>>

注意：输入格式坑

一开始我直接输入 1 2 3 4（用空格分隔），结果报错：Invalid choice: 1 2 3 4. Skipping.。后来发现需要用逗号分隔编号，或者每次运行命令只下载 1 个序号然后再次运行同样的命令下载剩余模型。
在这里插入图片描述

下载面部修复模型

因为报错是“面部修复模型缺失”，所以重点选 3. GFPGAN (face enhancement)。其他的可按需下载或全部重新下载。如果只需要修复功能，直接输入 3 并回车：

Enter the numbers of the models you want to download (comma-separated):
>> 3

等待下载完成

脚本会自动从官方链接下载 GFPGAN 模型，进度条显示下载状态：

Downloading GFPGAN (face enhancement)...
H:\PythonProjects1\Win_ComfyUI\models\face_restore\GFPGANv1.4.pth: 100%|█████| 348M/348M
Downloaded model to H:\PythonProjects1\Win_ComfyUI\models\face_restore\GFPGANv1.4.pth

在这里插入图片描述