名称	类型	含义
Torch is not able to use GPU	error	torch 是在没有 CUDA 的情况下安装的，驱动太旧，或者显卡是 AMD/Intel。重新安装带 CUDA 的 torch，或者根据你的硬件添加正确的参数。
NansException: A tensor with all NaNs was produced	error	VAE 或 Unet 中半精度溢出，SDXL 和某些合并检查点常见。使用 --no-half-vae，然后是 --no-half，或者用 fp16-fix VAE。
RuntimeError: CUDA out of memory	error	分辨率、批量大小、hires 修复或 ControlNet 超出显存。添加 --medvram（或 --medvram-sdxl）并降低 hires 放大倍数。
Couldn't install torch / No matching distribution	error	Python 版本错误（WebUI 需要 3.10.x）或网络被阻止。安装 Python 3.10.6，加入 PATH，删除 venv 文件夹后重新开始。
Stable diffusion model failed to load	error	检查点文件损坏或不完整，检查点文件夹里有 LoRA ，或者配置不匹配。重新下载，LoRA 保存在 models/Lora。
AttributeError: 'NoneType' object has no attribute ...	error	扩展版本与 WebUI 不匹配。禁用扩展，逐个更新。
xformers: WARNING ... / version mismatch	warning	xformers 编译时用的 torch 版本不对。去掉 --xformers，改用 --opt-sdp-attention，或者用 --reinstall-xformers 重新安装一次 xformers。
DefaultCPUAllocator: not enough memory	error	加载 6 GB SDXL 检查点时系统内存不足。关闭其他程序，增大页面文件，或者把检查点转成 fp16。
Connection errored out / Gradio timeout	symptom	Python 进程崩溃或卡住。看控制台；VAE 解码时崩溃通常是内存问题。
Images are black or green	symptom	半精度 VAE 在不支持的显卡上（GTX 16xx，部分 10xx）运行。加 --no-half-vae 或 --precision full --no-half。

无需安装 – 在云端运行 AI 模型

BitVector Prism 是最容易上手的方式:选择模型、输入提示词,即可在简洁的网页应用中生成,无需任何配置。BitVector 也提供 Discord 和网页版(SpyGlass)。

试用 BitVector

分步操作

确认 Python 3.10.x 和较新的 NVIDIA 驱动（启动时控制台会显示 torch 和 CUDA 版本；CUDA 不应显示为 "cpu"）。
编辑 webui-user.bat，设置 COMMANDLINE_ARGS。起步参数：--xformers 或 --opt-sdp-attention，8 GB 显卡加 --medvram，4 到 6 GB 加 --lowvram，SDXL 加 --no-half-vae。
把文件放到 WebUI 期望的位置：检查点放 models/Stable-diffusion，LoRA 放 models/Lora，
embedding
放 embeddings 文件夹，VAE 放 models/VAE，ControlNet 模型放 extensions/sd-webui-controlnet/models 或 models/ControlNet。
遇到 NansException，先加 --no-half-vae；如果没解决，再加 --no-half；SDXL 用 sdxl-vae-fp16-fix VAE 替代内置的。除非提示，否则别勾选“Upcast cross attention”。
内存错误先减参数再升级：批量大小 1，hires 修复不超过 1.5 倍，SD 1.5 用 512x768，SDXL 用 1024x1024，输出大时用 multidiffusion 扩展的 Tiled VAE。
更新后扩展坏了，先用 --disable-all-extensions 启动。如果能运行，分批在设置 > 扩展里重新启用，每次应用并重启，找到出错的扩展，更新或删除它。
安装损坏时，删除 venv 文件夹（只删这个），重新运行 webui-user.bat；几分钟内会重建环境，模型和输出不受影响。
显卡显存太小无法用 SDXL 或 ControlNet 时，使用同一检查点的云端服务：PirateDiffusion 用 /render 和模型触发词渲染，BitVector 在浏览器运行。

示例

适用于 8 GB 显卡和 SDXL 的 webui-user.bat

set COMMANDLINE_ARGS=--opt-sdp-attention --medvram-sdxl --no-half-vae --api

GTX 1660 / 1650（黑屏图像）

set COMMANDLINE_ARGS=--lowvram --precision full --no-half --opt-sdp-attention

重建环境

rmdir /s /q venv

webui-user.bat

技巧

A1111 更新慢；Forge（它的分支）集成了大部分修复，内存用量减半。本站有 Forge 指南介绍区别。
保持设置 > Stable Diffusion > SD VAE 为自动，每个检查点用同名 VAE 文件（model.safetensors 旁边放 model.vae.pt），避免坏的 VAE 全局生效。
别同时用 --lowvram 和 --medvram，后面那个生效，控制台会警告。
控制台出现 "Applying attention optimization: sdp" 表示快速注意力生效；如果显示 "Doggettx"，加 --opt-sdp-attention。
SDXL 检查点带 1.5 LoRA 会无声无效或尺寸错误；本站每个模型页都会标明系列，下载前确认。
更新后清理浏览器缓存（或用无痕窗口打开）；旧的 JavaScript 会导致奇怪的界面错误，看起来像服务器故障。

问题排查

Torch 无法使用 GPU

原因

只装了 CPU 版 torch，驱动太旧，或者显卡不是 NVIDIA。

修复方法

更新驱动，删除 venv，重新启动以安装带 CUDA 的 torch。Windows 上 AMD 用 DirectML 分支或 ZLUDA，Linux 用 ROCm。

SDXL 出现 NansException

原因

fp16 VAE 溢出。

修复方法

下载 sdxl-vae-fp16-fix，在 SD VAE 里选它，或者加 --no-half-vae。

hires 修复导致 CUDA 内存不足

原因

hires 修复需要多倍显存。

修复方法

降低放大倍数，使用潜空间放大器，开启 Tiled VAE，或者把 hires 过程改成

img2img

后处理。

无法安装 torch

原因

Python 版本是 3.11 或 3.12，不是 3.10。

修复方法

安装 Python 3.10.6，用 set PYTHON=path\python.exe 指向它，删除 venv，重启。

Stable diffusion 模型加载失败

原因

文件下载不完整或改名。

修复方法

重新下载，核对大小和模型页，保持原始扩展名。

git pull 后扩展标签页显示错误

原因

扩展写给旧版 WebUI。

修复方法

从扩展标签页更新每个扩展；删除不再维护的（管理器列表显示最后提交日期）。

模型加载但每张图都是噪点

原因

全局用了错误的 VAE，或者合并模型需要特定配置。

修复方法

把 SD VAE 设为自动，去掉全局 VAE，作者提供的话把检查点的 .yaml 放旁边。

无需安装 – 在云端运行 AI 模型

PirateDiffusion 仅在 Telegram 上提供,面向专业用户:数千个模型、LoRA 和工作流通过聊天命令驱动,固定价格套餐无限生成。

试用 PirateDiffusion

常见问题

Should I switch to Forge?

如果你显存 12 GB 或更少，建议切换；Forge 能跑 SDXL 和

Flux

，A1111 会卡，模型和大部分扩展都能用。本站 Forge 指南列出了区别。

Can A1111 run Flux?

不太行。Flux 支持在 Forge 和

ComfyUI

。本站的 Flux 模型会标明支持的 UI。

Where are my images?

在 outputs/txt2img-images 和 outputs/img2img-images，按日期分文件夹。设置 > 保存标签页可以改命名规则。

What do the model pages on this site give me for A1111?

准确的系列（SD 1.5 或 SDXL）、触发词、下载校验用的文件哈希和 Civitai 来源。LoRA 在提示词里写成 <lora:filename:0.8>。

Is there a way to try a model before downloading 6 GB?

有：每个模型页的运行框可以用本站显示的触发词，在 PirateDiffusion 或 BitVector 上远程运行。

链接与来源

本指南涉及的模型

Stable Diffusion 1.5 模型

Stable Diffusion XL 1.0 模型

作者

Captain

Automatic1111（Stable Diffusion WebUI）错误及修复

概述

参考

分步操作

示例

适用于 8 GB 显卡和 SDXL 的 webui-user.bat

GTX 1660 / 1650（黑屏图像）

重建环境

技巧

问题排查

Torch 无法使用 GPU

SDXL 出现 NansException

hires 修复导致 CUDA 内存不足

无法安装 torch

Stable diffusion 模型加载失败

git pull 后扩展标签页显示错误

模型加载但每张图都是噪点

常见问题

Should I switch to Forge?

Can A1111 run Flux?

Where are my images?

What do the model pages on this site give me for A1111?

Is there a way to try a model before downloading 6 GB?

链接与来源

本指南涉及的模型

相关指南

更多指南