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

问题定位

遇到 CheckpointLoaderSimple 报错，提示值不在列表中，通常是因为当前工作区内的模型文件名与配置文件要求的名称不一致。比如系统期望 v1-5-pruned-emaonly-fp16.safetensors，但实际只有 anything-v5-PrtRE.safetensors。

解决方案

第一步：获取基础模型 访问 HuggingFace 仓库下载官方推荐的 SD 1.5 模型： https://huggingface.co/runwayml/stable-diffusion-v1-5/tree/main

在页面中找到 v1-5-pruned-emaonly-fp16.safetensors（或同系列 fp16 版本），点击下载保存。

第二步：放置模型文件 将下载的 .safetensors 文件放入项目的 models/checkpoints 目录下。确保文件名完全匹配，避免多余的后缀或空格。

第三步：补充 VAE 文件 为了获得准确的色彩还原，建议同时下载标准 VAE： https://huggingface.co/stabilityai/sd-vae-ft-mse-original/tree/main

找到 vae-ft-mse-840000-ema-pruned.safetensors 并放入 models/vae 目录。

后续调试

环境配置完成后重启服务。如果初次生成的图像质量一般，不必气馁，这属于正常现象。通过微调采样步数、CFG 值等参数，很快就能得到理想的效果。