Stable Diffusion 模型加载报错修复指南

Stable Diffusion 模型加载报错修复指南

最近不少朋友在运行 Stable Diffusion WebUI 时遇到了 CheckpointLoaderSimple 相关的报错，提示找不到指定的 checkpoint 文件。这通常是因为当前工作目录下的模型列表与配置文件不匹配，或者缺少必要的预训练权重文件。

错误现象

控制台通常会抛出类似这样的信息：

CheckpointLoaderSimple: - 值不在列表中：ckpt_name: 'v1-5-pruned-emaonly-fp16.safetensors' 不在 ['anything-v5-PrtRE.safetensors'] 中

这意味着程序试图加载一个名为 v1-5-pruned-emaonly-fp16.safetensors 的模型，但你的 models/checkpoints 文件夹里只有 anything-v5-PrtRE.safetensors。

解决方案

1. 补充基础模型

你需要下载官方的 SD 1.5 基础模型。请前往 HuggingFace 下载以下文件：

v1-5-pruned-emaonly.safetensors

下载完成后，将其放入项目根目录下的 models/checkpoints 文件夹中。注意文件名最好保持一致，避免再次报错。

2. 配置标准 VAE

除了主模型，VAE（变分自编码器）也是生成图片质量的关键。如果缺失或版本不对，生成的图可能会发灰或模糊。建议添加标准的 VAE 文件：

vae-ft-mse-840000-ema-pruned.safetensors

将该文件放入 models/vae 目录下即可。

调试建议

完成上述步骤后重启服务。初次运行时，由于显存和模型加载的原因，生成效果可能不如预期稳定。别急着放弃，多尝试几次参数调整，很快就能得到满意的结果。如果遇到其他路径问题，记得检查 config.yaml 中的设置是否指向了正确的目录。