Stable Diffusion WebUI DirectML 安装与运行问题解决方案

问题概述

在使用 Stable Diffusion WebUI DirectML 项目时，用户遇到了两个主要的技术问题：磁盘空间不足导致的安装失败和 ONNX Runtime 库加载错误。本文将详细分析这些问题的成因并提供完整的解决方案。

问题一：磁盘空间不足错误

错误表现

在安装过程中，系统报错显示 [Errno 28] No space left on device，导致 torch 和 torchvision 安装失败。

原因分析

虽然用户磁盘显示有100GB剩余空间，但安装过程中仍出现空间不足的错误。这可能是由于：

1. 临时目录空间不足
2. 虚拟环境创建时分配的空间限制
3. 系统环境变量指向的临时目录空间不足

解决方案

1. 彻底清理系统临时文件和不需要的程序
2. 检查并清理虚拟环境目录
3. 确保系统环境变量TEMP和TMP指向有足够空间的目录
4. 考虑将项目安装到空间更大的磁盘分区

问题二：ONNX Runtime DLL加载失败

错误表现

安装完成后运行时出现 DLL load failed while importing onnxruntime_pybind11_state 错误。

原因分析

这是由于 ONNX Runtime 库与当前系统环境不兼容或安装不完整导致的。特别是当使用GPU版本时，可能会出现驱动或CUDA兼容性问题。

解决方案步骤

1. 激活虚拟环境

.\venv\Scripts\activate

2. 卸载现有ONNX Runtime

pip uninstall onnxruntime onnxruntime-gpu -y

3. 重新安装CPU版本

pip install onnxruntime

4. 运行WebUI时添加跳过参数

python launch.py --skip-ort

后续问题：图像生成失败

错误表现

成功启动后出现 RuntimeError: Input type (float) and bias type (struct c10::Half) should be the same 错误，导致无法生成图像。

原因分析

这是数据类型不匹配的问题，通常发生在：

1. 模型文件与当前框架版本不兼容
2. 硬件加速设置不当
3. 混合精度计算配置错误

解决方案

1. 检查并确保使用兼容的模型版本
2. 在配置文件中禁用混合精度计算
3. 尝试使用不同的torch版本
4. 在启动参数中添加 --precision full 强制使用全精度计算

最佳实践建议

1. 安装前准备：

   • 确保系统有至少50GB可用空间
   • 更新显卡驱动到最新版本
   • 安装必要的运行库

2. 环境配置：

   • 使用干净的Python虚拟环境
   • 按顺序安装依赖项
   • 记录安装过程中的版本信息

3. 故障排查：

   • 查看完整错误日志
   • 逐步测试各组件功能
   • 在社区寻求帮助时提供完整系统信息

通过以上方法，大多数安装和运行问题都能得到有效解决。对于特定硬件配置，可能需要额外的调优工作。