遇到 CheckpointLoaderSimple 报错,提示值不在列表中,通常是因为当前工作区缺少指定的模型文件,或者文件名与配置文件不匹配。例如报错信息中显示需要的 v1-5-pruned-emaonly-fp16.safetensors 并不在可用列表里。
问题排查与解决
要解决这个问题,我们需要确保模型目录下的文件名称与启动参数完全一致。以下是标准的修复步骤:
1. 下载基础模型
你需要获取 Stable Diffusion v1.5 的基础检查点文件。该文件是生成图像的核心权重包。
- 文件名:
v1-5-pruned-emaonly.safetensors - 下载地址:HuggingFace - SD v1.5
- 存放路径:将下载的文件放入
models/checkpoints目录下。
2. 配置 VAE 文件
除了主模型,运行还需要标准的 VAE(变分自编码器)文件来保证色彩还原和细节质量。
- 文件名:
vae-ft-mse-840000-ema-pruned.safetensors - 下载地址:HuggingFace - SD VAE
- 存放路径:将下载的文件放入
models/vae目录下。
注意事项
完成上述文件放置后,重启程序即可解决验证失败的问题。初次运行时生成的图片效果可能不够理想,这属于正常现象,建议根据具体需求调整采样器、步数等参数进行微调。只要环境配置正确,后续迭代会很快得到满意的结果。

