跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI算法

Stable Diffusion 报错修复:CheckpointLoaderSimple 模型加载失败处理

Stable Diffusion 启动时出现 CheckpointLoaderSimple 验证失败,通常因模型文件缺失或名称不匹配导致。解决方案需下载 v1-5 基础模型及标准 VAE 文件,分别放入 checkpoints 和 vae 目录。确保文件名与配置文件一致即可解决报错。

SecGuard发布于 2026/3/30更新于 2026/6/1520 浏览

遇到 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 目录下。

注意事项

完成上述文件放置后,重启程序即可解决验证失败的问题。初次运行时生成的图片效果可能不够理想,这属于正常现象,建议根据具体需求调整采样器、步数等参数进行微调。只要环境配置正确,后续迭代会很快得到满意的结果。

目录

  1. 问题排查与解决
  2. 1. 下载基础模型
  3. 2. 配置 VAE 文件
  4. 注意事项
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • AI 时代如何脱颖而出:商业认知与行动指南
  • 人形机器人躯干系统设计与结构方案
  • Bun 运行时:比 Node.js 更快的 JavaScript 开发新选择
  • C++ 虚函数与纯虚函数:深入理解多态机制
  • Flutter WalletConnect 鸿蒙化适配指南:Web3 钱包连接与 DApp 授权实战
  • Linux Mint 22.3 安装指南与系统优化实战
  • GESP-C++ 三级考试核心考点与编程实战模板
  • C++ 哈希表封装:模拟实现 unordered_map 与 unordered_set
  • Faster-Whisper 本地部署:实现实时语音转文本实战指南
  • GitHub Copilot 使用体验与功能场景分析
  • Java 连接 Elasticsearch 8.x 安全模式:证书校验与 ApiKey 认证
  • GitHub Copilot 学生认证实操指南:免费获取 Pro 权益
  • 大模型落地路线图研究报告(2024 年)
  • pyenv-win Python 多版本管理实战与效率优化方案
  • 降低 AIGC 检测率的提示词优化策略与实践指南
  • 15 个提示词降低 AIGC 检测率,让写作更像人类
  • PyTorch 文本引导图像生成与 Stable Diffusion 实践
  • 基于 Java 的消息队列选型总结:RabbitMQ、RocketMQ、Kafka 实战对比
  • LLM 申请 Hugging Face 访问令牌(以 Meta-Llama-3.1-8B-Instruct 为例)
  • Web 聊天室消息加解密方案详解

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online