Appearance
Stable Diffusion WebUI 常见报错排查：启动失败、OOM、黑图速查清单
Stable Diffusion WebUI（AUTOMATIC1111 等）报错时，最差的做法是立刻重装、乱下扩展，或换一篇过时教程逐条盲试。更好的做法是：先给错误分类，再按最小路径验证。这篇是 Stable Diffusion WebUI 常见报错排查清单：按症状索引，每条给出可能原因、优先检查项、以及「修好的定义」。默认你已能打开界面；入门参数见 Stable Diffusion 使用教程。若你实际用的是节点工作流，请改走 ComfyUI 常见报错排查。
排查总原则（先读这 5 条）
- 看启动终端，不只看网页红字：细节多在黑色控制台。
- 一次只改一个变量：同时换模型、降分、关扩展，你会不知道谁治好的。
- 先回到最小出图：默认采样器、单张、中等步数、关高清修复与多余扩展。
- 扩展是加速器也是炸弹：更新 WebUI 后先排扩展冲突。
- OOM 优先降需求：分辨率、batch、放大链，比「再装一个省显存神话」更可靠。
不要从重装系统开始；从「能出一张丑图」开始。
症状速查表
| 症状 | 先跳到 |
|---|---|
| 启动失败 / 闪退 / 依赖报错 | A 类 |
| CUDA OOM / 显存不足 | B 类 |
| 全黑、绿图、彩噪、破图 | C 类 |
| 模型列表空、加载失败 | D 类 |
| 扩展导致红字 / 按钮消失 | E 类 |
| 出图极慢或卡住无进度 | F 类 |
A 类：启动失败 / 闪退
可能原因：Python/Git 环境坏、依赖版本冲突、路径含特殊权限、显卡驱动异常。
检查顺序：
- 用同一方式启动，复制终端最后 30 行；
- 确认装在非系统保护目录，路径尽量短、少奇怪权限；
- 临时禁用新增扩展目录后再启动；
- 仍失败：按官方方式修复 venv/依赖，而不是混装全局包。
修好的定义：WebUI 能稳定打开，并完成一次最小出图。
B 类：CUDA OOM / 显存爆了
可能原因：分辨率过高、batch>1、高清修复/放大过猛、多模型残留占用。
检查顺序：
- 宽高回到 512 边长量级；
- batch count/size 设为 1；
- 关闭 Hires fix / 额外 upscaler；
- 关掉其他占 GPU 程序；
- 仍 OOM：换更小模型或接受更低分辨率。
修好的定义：降低需求后可稳定出图；再逐步加回放大。
OOM 的正确姿势是减负验证，不是先重装。
C 类：黑图、绿图、彩噪、破图
可能原因：VAE 不匹配、模型文件损坏、采样参数极端、精度/半精度设置不适配。
检查顺序：
- 换一个确认能用的 Checkpoint 对照；
- 检查 VAE 是否需指定或改为自动/无；
- 把 steps/CFG 拉回常见区间再测；
- 重新下载模型并核对文件体积；
- 查阅当前 WebUI 与显卡环境下的精度相关选项（一次只改一项）。
修好的定义：默认合理参数下出现可识别图像，再谈调优。
D 类：找不到模型 / 加载失败
可能原因：文件放错目录、后缀不对、下载不完整、文件名与预期不符。
检查顺序：
- 对照当前 WebUI 版本的模型目录放置 ckpt/safetensors；
- 刷新列表后确认文件名可见；
- 优先使用 safetensors，并避免未下完的临时文件；
- 大文件校验体积；损坏则重下。
修好的定义：下拉可选中模型并完成一次采样。
E 类：扩展冲突
可能原因：扩展未更新、与 WebUI 版本不兼容、两个扩展抢同一功能。
检查顺序：
- 记下报错里的扩展名；
- 禁用最近安装的扩展，二分法定位；
- 只恢复最小必需扩展；
- 更新扩展与 WebUI 时分开做，便于回滚。
修好的定义：禁用冲突扩展后功能恢复；再决定是否替换该扩展。
F 类：极慢或卡住
可能原因：首次编译/下载、CPU 误用、磁盘占用高、进度实际在终端报错。
检查顺序：
- 看终端是否仍有新日志；
- 确认实际走 GPU 而非意外落 CPU；
- 取消任务，回最小出图；
- 检查磁盘空间与杀毒拦截输出目录；
- 驱动更新仅作后手。
修好的定义：最小出图在可预期时间内完成并保存。
30 分钟自检流程（可照做）
- 启动后跑最小出图（5–10 分钟）；
- 再复现问题操作（不要同时改参数）；
- 按症状进 A–F；
- 每改一项就出一张；
- 记录：症状 / 终端关键行 / 改动 / 结果。
什么时候该停手去换路线
- 显存长期不够业务分辨率；
- 你需要可保存、可交接的复杂管线；
- 扩展地狱耗时超过学节点的时间。
先回选型：AI 绘画工具怎么选；复杂管线优先评估 ComfyUI。
Stable Diffusion WebUI 报错排查：FAQ
Q：重装 WebUI 能解决大部分问题吗？ A：只能缓解环境腐烂。放错模型、OOM、扩展冲突，重装不一定有效。
Q：为什么别人同样参数我出废图？ A：模型版本、VAE、扩展、精度与随机种子都可能不同；先对齐模型文件与最小参数。
Q：要不要一上来装一堆扩展？ A：不要。最小出图稳定后再加，且一次加一个。
Q：和 ComfyUI 报错通用吗？ A：OOM 与模型损坏通用；红节点与工作流 JSON 问题请看 ComfyUI 专文。
结语
WebUI 的稳定性，来自 最小出图 + 单变量 + 终端日志，不是来自运气。把本文当抽屉清单：启动看 A，显存看 B，废图看 C。基础操作仍以教程为准；反复 OOM 或扩展缠身时，先回到绘画工具选型，再决定是否迁到 ComfyUI 管线。
延伸阅读
排错步骤针对常见 WebUI 情况；具体栈追踪随版本与扩展而变，请以你的终端日志与项目文档为准。