WebUI 上游问题

识别模型、扩展、节点、生成和 WebUI 界面错误，并前往对应问题库。

当 WebUI 已经获得可访问地址，而错误发生在生成图片、加载模型、运行工作流、使用扩展或操作 WebUI 页面时，问题通常来自 WebUI Core、扩展、模型或实例依赖，不属于 Hanafubuki 的界面和任务系统。

先保存核心错误

Python traceback 会从 Traceback (most recent call last): 开始列出调用路径，最后没有缩进的异常类型和描述通常最适合搜索，例如：

ModuleNotFoundError: No module named 'example'

不要只复制这一行。求助时仍应附上完整 traceback、错误前的扩展/节点名称、当前模型和操作步骤，因为相同异常可能由不同组件触发。

现象	优先检查
CUDA、Torch、显卡不可用	显卡驱动、实例 PyTorch、当前平台组合
内存或显存不足、NaN、黑图	分辨率、批量、精度、VAE、显存策略和模型兼容性
LoRA、ControlNet、VAE 或文本编码器错误	模型家族和所需组件是否匹配
`ImportError`、`No module named`、扩展加载失败	报错路径对应的扩展、依赖和版本
ComfyUI 节点缺失或爆红	自定义节点是否安装、导入是否成功、输入和上游节点参数
WebUI 页面挤压、按钮失效或模型无法切换	浏览器翻译、缓存、扩展前端脚本和 WebUI 版本
生成按钮无反应但进程仍在	浏览器控制台、WebUI 终端日志和队列状态

创建环境快照，并记录当前 Core、扩展、PyTorch 和模型状态。

确认错误是否只在特定模型、工作流、节点或扩展出现。

查看 traceback 路径；优先禁用或更新直接出现的扩展，不要一次卸载全部扩展。

使用“版本”“扩展”“PyTorch”和“模型”页面执行受管操作，并在每次修改后复现同一场景。

需要运行包检查命令时使用实例终端，不要在普通应用终端修改实例环境。

SD Note 收集了大量 SD WebUI 和 ComfyUI 常见错误，并说明如何从控制台提取报错。确认问题属于 WebUI 上游后，可以按 WebUI 类型前往：

学习查找错误、搜索和准备求助信息。

查询 SD WebUI、Forge、模型和扩展错误。

查询节点、工作流、依赖和自定义节点错误。

不要照搬其他启动器的按钮路径

SD Note 中部分解决步骤面向“绘世启动器”。错误原因和上游修复思路可以参考，但版本、扩展、PyTorch、终端、代理和环境操作应在 Hanafubuki 对应页面完成。不要复制其他启动器的受管目录或直接运行其专用修复命令。

SD Note 没有收录时，可使用异常类型、最后一行描述、WebUI 名称和扩展名搜索官方仓库 Issue。优先阅读 Core 或扩展作者的说明，注意方案适用的版本和操作系统。

报告时说明使用 Hanafubuki 启动，但不要只提供 Hanafubuki 截图；上游维护者通常更需要 WebUI 版本、完整 traceback 和最小复现步骤。