ComfyUI-Inpaint-Nodes图像修复模型加载失败：3步诊断与解决方案

ComfyUI-Inpaint-Nodes图像修复模型加载失败：3步诊断与解决方案

【免费下载链接】comfyui-inpaint-nodesNodes for better inpainting with ComfyUI: Fooocus inpaint model for SDXL, LaMa, MAT, and various other tools for pre-filling inpaint & outpaint areas.项目地址: https://gitcode.com/gh_mirrors/co/comfyui-inpaint-nodes

在使用ComfyUI-Inpaint-Nodes进行AI图像修复时，您可能会遇到"Weights only load failed"错误提示，导致无法正常使用Fooocus、LaMa或MAT等高级修复功能。本文将为您详细解析问题根源，并提供两种清晰的解决路径，让您快速恢复图像修复工作流。

🔍 问题现象与诊断

当您尝试使用ComfyUI-Inpaint-Nodes进行图像修复时，系统可能提示以下几种错误：

1. 权重加载失败：控制台显示"Weights only load failed"或类似错误信息
2. 节点无法初始化：Fooocus Inpaint、LaMa或MAT相关节点显示为红色或无法连接
3. 预处理功能缺失：无法使用Telea、Navier-Stokes等高级填充算法

这些问题通常源于模型文件问题或路径配置错误。ComfyUI-Inpaint-Nodes依赖多个外部模型文件，如果这些文件缺失或损坏，就会导致整个修复流程中断。

⚙️ 核心原理：模型文件的作用

理解模型文件的作用有助于您更好地解决问题：

这些模型文件构成了ComfyUI-Inpaint-Nodes的核心能力。Fooocus模型通过补丁机制增强SDXL模型的修复能力，而LaMa和MAT则提供专门的修复算法。

📋 解决方案一：完整模型下载与验证

这是最彻底的解决方案，适用于首次安装或模型文件完全缺失的情况。

步骤1：下载所有必需模型文件

根据您的修复需求，下载相应的模型文件：

Fooocus Inpaint模型（SDXL修复必备）

# 从Hugging Face下载 fooocus_inpaint_head.pth inpaint_v26.fooocus.patch

LaMa模型（快速修复）

# 从GitHub Releases下载 big-lama.pt

MAT模型（高质量修复）

# 选择其中一个版本下载 Places_512_FullData_G.pth MAT_Places512_G_fp16.safetensors # 推荐，文件更小

步骤2：创建正确的目录结构

在ComfyUI安装目录下创建模型文件夹：

# 进入ComfyUI目录 cd /path/to/ComfyUI # 创建inpaint模型目录 mkdir -p models/inpaint

步骤3：文件完整性验证

下载完成后，验证文件是否完整：

# 检查文件大小（示例） ls -lh models/inpaint/ # 预期输出类似： # -rw-r--r-- 1 user user 42M Jan 15 10:30 fooocus_inpaint_head.pth # -rw-r--r-- 1 user user 1.2M Jan 15 10:30 inpaint_v26.fooocus.patch # -rw-r--r-- 1 user user 140M Jan 15 10:31 big-lama.pt

步骤4：重启ComfyUI

完成文件放置后，重启ComfyUI服务使更改生效。

🔧 解决方案二：快速诊断与修复

如果您已经下载了模型文件但仍有问题，请按以下步骤诊断。

诊断表：常见问题排查

文件路径验证脚本

创建一个简单的Python脚本验证路径：

import os import sys # 检查模型目录 model_dir = "models/inpaint" required_files = [ "fooocus_inpaint_head.pth", "inpaint_v26.fooocus.patch", "big-lama.pt" ] print("🔍 检查模型文件...") for file in required_files: path = os.path.join(model_dir, file) if os.path.exists(path): size = os.path.getsize(path) / (1024*1024) # MB print(f"✅ {file}: {size:.1f} MB") else: print(f"❌ {file}: 文件缺失")

网络下载优化技巧

如果下载速度慢或经常中断：

1. 使用镜像源：寻找国内镜像或使用下载工具
2. 分步下载：先下载必需模型（Fooocus），再下载可选模型
3. 验证哈希：下载后验证SHA256确保文件完整

🚫 常见误区与注意事项

误区1：将模型文件放在错误位置

❌错误做法：将.pth或.safetensors文件放在custom_nodes/comfyui-inpaint-nodes/目录下

✅正确做法：所有模型文件必须放在ComfyUI/models/inpaint/目录中

误区2：使用不兼容的检查点

Fooocus Inpaint需要常规版本的SDXL检查点，不支持以下类型：

• Turbo/Lightning等蒸馏合并版本
• 过时的模型版本
• 非SDXL基础模型

误区3：忽略OpenCV依赖

如果您需要使用Telea或Navier-Stokes填充算法，必须安装OpenCV：

pip install opencv-python

误区4：未重启ComfyUI

添加或更新模型文件后，必须重启ComfyUI才能生效。

📊 预处理方法效果对比

了解不同预处理方法的效果有助于您选择合适的修复策略：

原始输入图像 - 包含待修复的红色小船区域

预处理方法	效果图示	适用场景	特点
中性填充		完全替换内容	灰色填充，无过渡效果
Telea算法		自然纹理扩展	基于纹理合成，过渡自然
Navier-Stokes		流体般平滑过渡	基于流体动力学方程
轻度模糊		颜色保持	半径17的模糊，保留部分纹理
重度模糊		完全模糊处理	半径65的模糊，纹理丢失
LaMa修复		高质量物体移除	深度学习修复，效果最佳
MAT修复		快速部分修复	矩阵分解，半透明效果

🛠️ 高级故障排除

检查ComfyUI日志

查看ComfyUI启动日志，寻找模型加载相关错误：

# 查看最近错误日志 tail -f ~/.cache/comfyui/logs/comfyui.log | grep -i "inpaint\|model\|weight"

验证节点兼容性

确保您的ComfyUI版本与inpaint-nodes兼容：

1. 检查ComfyUI版本：python -c "import comfy; print(comfy.__version__)"
2. 确认custom_nodes目录结构正确
3. 验证Python依赖：pip list | grep -E "torch|opencv"

工作流示例验证

使用项目提供的工作流文件测试基本功能：

1. 打开ComfyUI界面
2. 加载workflows/inpaint-simple.json工作流
3. 确保所有节点连接正常
4. 逐步测试每个修复功能

完整的图像修复工作流示例 - 从图像加载到最终输出

📚 扩展学习资源

官方文档与示例

• 项目配置文件：查看pyproject.toml了解依赖要求
• 节点实现：研究nodes.py了解各修复节点的实现逻辑
• 工具函数：参考util.py中的辅助函数

工作流模板

项目提供了多个预配置工作流，位于workflows/目录：

1. 简单修复：inpaint-simple.json- 基础修复流程
2. 精细调整：inpaint-refine.json- 支持1-100%去噪强度
3. 图像扩展：outpaint.json- 专门用于图像扩展
4. 预处理实验：inpaint-preprocess.json- 多种预处理方法对比

进阶技巧

1. 组合使用预处理：先使用LaMa快速修复，再用Fooocus进行细节优化
2. 掩码扩展技巧：使用Expand Mask节点平滑修复边界
3. 颜色匹配：修复后使用Color Match (Masked)调整色彩一致性

✅ 总结与最佳实践

通过本文的指导，您应该能够解决大多数ComfyUI-Inpaint-Nodes模型加载问题。记住以下关键点：

1. 路径正确性：所有模型文件必须放在ComfyUI/models/inpaint/目录
2. 文件完整性：下载后验证文件大小和哈希值
3. 版本兼容性：使用正确的模型版本和检查点类型
4. 依赖完整性：确保OpenCV等依赖项已安装

如果问题仍然存在，建议：

1. 完全删除models/inpaint/目录并重新下载
2. 检查网络连接和下载源
3. 查看ComfyUI社区或项目Issues寻求帮助

现在，您可以重新启动ComfyUI，享受强大的图像修复功能了！🎨

【免费下载链接】comfyui-inpaint-nodesNodes for better inpainting with ComfyUI: Fooocus inpaint model for SDXL, LaMa, MAT, and various other tools for pre-filling inpaint & outpaint areas.项目地址: https://gitcode.com/gh_mirrors/co/comfyui-inpaint-nodes