SD生图下载时模型权重缺失怎么办？

Question

在使用Stable Diffusion（SD）进行生图时，用户常遇到“模型权重缺失”问题：下载完模型后，加载时报错提示“Unable to load weights”或“No such file or directory”。该问题通常因模型文件未完整下载、存放路径错误、文件命名不匹配或未放入正确的模型目录（如models/Stable-diffusion）所致。此外，部分用户误将CKPT文件放在LoRA文件夹中，也会导致识别失败。需检查文件完整性、校验MD5值，并确保前端工具（如WebUI）与模型版本兼容。

Answer 1

1. 问题现象与常见报错信息

在使用 Stable Diffusion（SD）进行图像生成时，用户频繁遭遇“模型权重缺失”问题。典型表现包括：

• Unable to load weights from checkpoint
• No such file or directory: 'models/Stable-diffusion/model.ckpt'
• WebUI 启动后未列出已下载的主模型

这些问题往往并非源于代码缺陷，而是配置、路径或文件管理层面的疏漏。

2. 常见原因分类分析

类别	具体表现	影响范围
文件未完整下载	模型文件大小异常，如仅几百 KB	所有前端工具均无法加载
存放路径错误	CKPT 文件置于 models/Lora 而非 models/Stable-diffusion	WebUI 忽略该模型
命名不规范	含特殊字符或空格，如 my model v1.ckpt	Python 解析失败
版本兼容性问题	SDXL 模型用于仅支持 SD 1.5 的 WebUI 分支	加载时报 tensor 不匹配

3. 深度排查流程图

graph TD
    A[启动失败: Unable to load weights] --> B{检查日志路径}
    B --> C[确认期望加载的 .ckpt/.safetensors 路径]
    C --> D[验证文件是否存在]
    D --> E{存在?}
    E -- 否 --> F[检查下载完整性]
    E -- 是 --> G[校验 MD5 值]
    G --> H{MD5 匹配?}
    H -- 否 --> I[重新下载]
    H -- 是 --> J[检查模型目录结构]
    J --> K[是否位于 models/Stable-diffusion/]
    K -- 否 --> L[移动至正确目录]
    K -- 是 --> M[确认 WebUI 支持该模型架构]
    M --> N[重启并加载]
    

4. 解决方案实施步骤

1. 定位模型存储根目录：stable-diffusion-webui/models/Stable-diffusion/
2. 确保所有主模型（.ckpt 或 .safetensors）存放于此路径下
3. 避免将 LoRA 模型与主干模型混放
4. 重命名文件为无空格、无中文、无特殊符号格式，例如：realisticVisionV6.safetensors
5. 通过命令行校验文件完整性：

   # Linux/Mac 校验示例
   md5 model.ckpt
   
   # Windows 使用 CertUtil
   CertUtil -hashfile model.ckpt MD5
   

6. 对比官方发布页提供的 MD5 值，确保一致
7. 若使用 Git 子模块或自动化脚本，检查 pull 过程是否中断
8. 确认所用 WebUI 分支（如 AUTOMATIC1111、ComfyUI）支持目标模型类型
9. 对于 SDXL 模型，需运行支持 diffusers pipeline 的新版 WebUI
10. 清除浏览器缓存后刷新模型列表，防止前端缓存误导

5. 高级调试技巧

对于资深开发者，可启用 WebUI 的详细日志模式：

python launch.py --log-level DEBUG

观察输出中关于 load_state_dict 的调用栈，判断是 I/O 错误还是 tensor shape 不匹配。此外，可通过 Python 动态检查模型结构：

import torch
checkpoint = torch.load("models/Stable-diffusion/model.ckpt", map_location="cpu")
print(checkpoint.keys())  # 查看是否包含 state_dict

若返回 KeyError 或结构异常，则说明文件损坏或格式不符。