如何调试Stable Diffusion报错

调试 Stable Diffusion（SD）报错 通常可以按下面这个思路来，先定位是哪一类问题，再逐步排查。下面我按常见报错类型 + 排查步骤给你一个实用指南。

一、先确认基础环境（90% 问题出在这里）

1️⃣ Python 版本

• ✅ 推荐：Python 3.10
• ❌ 不推荐：3.11 / 3.12（很多依赖还不兼容）

检查：

python --version

2️⃣ CUDA & 显卡驱动

如果你是 NVIDIA 显卡：

nvidia-smi

确认：

• CUDA Version ≥ 11.7
• 驱动版本不要太旧

✅ 推荐：

• CUDA 11.8 + PyTorch 2.x

3️⃣ PyTorch 是否正确安装

python -c "import torch; print(torch.cuda.is_available())"

• 返回 True ✅
• 返回 False ❌（CPU 或 CUDA 没装好）

重新安装（示例）：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

二、常见报错 & 解决方法

❌ 1. CUDA out of memory

原因：显存不足
✅ 解决方案：

• 降低分辨率：512×512 → 384×384
• 降低 batch size（WebUI 里设为 1）
• 开启 --medvram 或 --lowvram

--medvram
--lowvram

❌ 2. No module named 'x' / ModuleNotFoundError

原因：依赖没装全
✅ 解决：

pip install -r requirements.txt

如果还缺：

pip install 模块名

❌ 3. Torch not compiled with CUDA enabled

原因：装了 CPU 版 PyTorch
✅ 解决：

pip uninstall torch
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

❌ 4. WebUI 启动直接闪退

✅ 排查顺序：

1. 用 命令行启动，不要双击
2. 看最后 10 行报错
3. 常见问题：

• Python 版本不对
• Git 没装
• .venv 损坏

✅ 可尝试：

rm -rf venv
python launch.py

❌ 5. Model loading failed / CKPT error

原因：

• 模型损坏
• SD1.5 / SDXL 混用
• VAE 不匹配

✅ 解决：

• 重新下载模型（推荐从 HuggingFace / Civitai）
• 确认：
• SD1.5 → 1.5 模型
• SDXL → XL 模型
• 暂时不加载 VAE 测试

三、调试技巧（很关键）

✅ 1. 永远用命令行启动

python launch.py --verbose

能看到真实错误，而不是闪退。

✅ 2. 看最后 5～10 行错误

Python 报错重点在：

• 最后一行
• Traceback (most recent call last)

✅ 3. 最小复现

• 不装插件
• 不换模型
• 默认参数跑一次

如果成功 → 再逐步加插件 / 模型

四、如果你愿意，我可以直接帮你定位

你可以直接把 完整报错信息 发给我（哪怕很长），我可以直接告诉你：
✅ 是环境
✅ 是显存
✅ 是模型
✅ 是插件冲突
你可以直接贴类似这种内容：

Traceback (most recent call last):
File "launch.py", line xx
...
RuntimeError: CUDA error

或者告诉我：

• 你用的是 WebUI / ComfyUI / 本地脚本
• 显卡型号
• 系统（Windows / Linux / macOS）

我可以一步一步带你修 ✅