首页
/ Stable Diffusion WebUI DirectML 模型加载失败问题分析与解决

Stable Diffusion WebUI DirectML 模型加载失败问题分析与解决

2025-07-04 10:41:04作者:郜逊炳

问题现象

在使用 Stable Diffusion WebUI DirectML 项目时,部分用户遇到了模型无法加载的问题。主要症状表现为:

  1. 启动 WebUI 后无法显示任何模型
  2. 控制台报错显示 "No checkpoints found"
  3. 设置无法保存,所有设置项显示错误
  4. 刷新模型列表功能失效

错误分析

从错误日志中可以观察到几个关键信息:

  1. 系统在以下路径查找模型文件失败:

    • 项目根目录下的 model.ckpt 文件
    • models/Stable-diffusion 目录
  2. 核心错误信息为:

    FileNotFoundError: No checkpoints found. When searching for checkpoints, looked at:
    - file C:\stabledf\stable-diffusion-webui-directml\model.ckpt
    - directory C:\stabledf\stable-diffusion-webui-directml\models\Stable-diffusion
    
  3. 后续还出现了 AttributeError,表明在模型加载失败后,程序尝试访问不存在的模型属性

问题原因

经过分析,该问题主要由以下几个因素导致:

  1. 模型文件缺失:系统无法在指定路径找到任何 .ckpt 或 .safetensors 格式的模型文件

  2. 路径配置问题:部分情况下,模型搜索路径可能被错误配置

  3. 初始化顺序问题:在最新修复前,程序可能在模型下载完成前就尝试加载模型

解决方案

基本解决方法

  1. 确保模型文件存在

    • 将模型文件(.ckpt 或 .safetensors)放置在正确目录:
      • 项目根目录
      • 或 models/Stable-diffusion 子目录
  2. 使用最新版本

    • 更新到最新版本的 Stable Diffusion WebUI DirectML
    • 最新版本已修复了模型下载和初始化的顺序问题
  3. 重新初始化

    • 删除 venv 文件夹后重新初始化环境
    • 最新版本会在首次运行时自动下载 v1-5-pruned-emaonly.safetensors 模型

高级排查步骤

如果问题仍然存在,可以尝试:

  1. 检查目录权限,确保程序有权限访问模型目录

  2. 验证模型文件完整性,损坏的模型文件可能导致加载失败

  3. 检查环境变量,确保没有冲突的路径设置

技术背景

Stable Diffusion WebUI DirectML 是专为 AMD 显卡优化的 Stable Diffusion 实现版本。它使用 DirectML 作为计算后端,而不是传统的 CUDA。在模型加载机制上:

  1. 程序会按照预设路径搜索模型文件
  2. 如果找不到模型,会尝试从默认源下载
  3. 模型加载失败会导致后续所有依赖模型的功能无法工作

最佳实践建议

  1. 始终使用最新版本的项目代码

  2. 将模型文件统一存放在 models/Stable-diffusion 目录下

  3. 首次运行时耐心等待自动下载完成

  4. 定期清理不再使用的模型以节省空间

总结

模型加载失败问题在最新版本的 Stable Diffusion WebUI DirectML 中已得到修复。用户只需确保使用最新代码,并按照标准方式存放模型文件即可避免此类问题。对于 AMD 显卡用户,DirectML 版本提供了良好的性能支持,是运行 Stable Diffusion 的优秀选择。

登录后查看全文
热门项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
163
2.05 K
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
199
279
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
60
16
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
952
558
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
96
15
apintoapinto
基于golang开发的网关。具有各种插件,可以自行扩展,即插即用。此外,它可以快速帮助企业管理API服务,提高API服务的稳定性和安全性。
Go
22
0
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
77
71
giteagitea
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
17
0