512-inpainting-ema.safetensors加载失败？

Question

在使用Stable Diffusion模型进行图像修复时，用户常遇到“512-inpainting-ema.safetensors加载失败”的问题。该错误通常表现为模型文件无法被正确读取或解析，可能原因包括：文件不完整、下载中断导致损坏、路径包含中文或特殊字符、模型未正确放置于`models/Stable-diffusion`目录下，或与当前WebUI版本不兼容。此外，部分安全软件可能误删文件内容。建议重新下载模型文件，校验SHA256值确保完整性，并检查控制台具体报错信息以定位问题。

Answer 1

Stable Diffusion 图像修复中“512-inpainting-ema.safetensors加载失败”问题深度解析

1. 问题现象与初步诊断

在使用 Stable Diffusion WebUI 进行图像修复（Inpainting）时，用户频繁报告如下错误：

[ERROR] Cannot load model: 512-inpainting-ema.safetensors - Failed to parse Safetensor file

该报错通常出现在启动 WebUI 或切换模型时。控制台日志显示文件无法被正确读取或解析，导致 Inpainting 功能不可用。此问题虽不直接影响文生图流程，但严重阻碍局部重绘等关键创作功能。

2. 常见原因分类分析

根据社区反馈与实测验证，可将问题归因于以下几类：

1. 文件完整性受损：下载过程中网络中断、镜像源异常导致文件截断或损坏。
2. 路径问题：模型文件存放路径包含中文字符、空格或特殊符号（如#、&），Python 文件系统调用解析失败。
3. 目录结构错误：未将模型置于models/Stable-diffusion/目录下，而是误放于models/ESRGAN或其他子目录。
4. 版本兼容性问题：使用的 WebUI 版本（如 v1.6.0+）对 safetensors 格式支持存在变更，旧版模型可能无法加载。
5. 安全软件干扰：杀毒软件（如 Windows Defender、360）误判模型为潜在威胁并清空文件内容。

3. 深度排查流程图

graph TD
            A[出现加载失败错误] --> B{检查文件是否存在}
            B -- 否 --> C[重新下载模型]
            B -- 是 --> D[校验SHA256哈希值]
            D --> E{哈希匹配?}
            E -- 否 --> C
            E -- 是 --> F[检查存放路径是否含中文/特殊字符]
            F --> G{路径合规?}
            G -- 否 --> H[移动至纯英文路径]
            G -- 是 --> I[确认位于models/Stable-diffusion目录]
            I --> J{位置正确?}
            J -- 否 --> K[迁移文件]
            J -- 是 --> L[关闭杀毒软件并重试]
            L --> M[查看控制台详细日志]
            M --> N{是否仍有错误?}
            N -- 是 --> O[升级WebUI或更换模型版本]
            N -- 否 --> P[问题解决]

4. 解决方案与操作步骤

步骤	操作说明	工具/命令
1	重新下载官方推荐的 512-inpainting-ema.safetensors 模型	CivitAI 或 HuggingFace 官方链接
2	计算 SHA256 值进行完整性校验	sha256sum 512-inpainting-ema.safetensors
3	确保模型存放路径为全英文且无空格	例如：D:/sd/models/Stable-diffusion/
4	确认模型已放入正确的目录层级	路径必须为：models/Stable-diffusion/
5	临时禁用杀毒软件扫描行为	Windows Defender 实时保护关闭
6	更新 WebUI 至最新主分支版本	git pull origin master
7	若仍失败，尝试使用兼容性更高的替代模型	如：runwayml/stable-diffusion-inpainting
8	启用 WebUI 启动参数以增强调试信息	--no-half --precision full --debug
9	检查 Python 环境中 safetensors 库是否安装	pip install safetensors
10	查看 logs/error.log 获取底层异常堆栈	定位具体是 I/O 错误还是格式解析异常

5. 高级调试建议（面向资深开发者）

对于具备 Python 和 PyTorch 调试能力的技术专家，可通过以下方式深入定位：

• 在modules/sd_models.py中插入日志断点，观察load_model_from_file()函数执行流。
• 使用huggingface_hub库直接从远程拉取模型并缓存，绕过本地文件风险。
• 编写脚本预加载模型以隔离 WebUI 复杂逻辑：

from safetensors.torch import load_file
import torch

try:
    state_dict = load_file("models/Stable-diffusion/512-inpainting-ema.safetensors")
    print("Model loaded successfully with", len(state_dict), "tensors.")
except Exception as e:
    print("Load failed:", str(e))

此方法可快速判断是模型本身问题还是 WebUI 加载机制缺陷。