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 中的设置是否指向了正确的目录。

