Stable Diffusion WebUI 安装卡在"Installing requirements"问题分析

问题现象

在使用Stable Diffusion WebUI时，许多用户遇到了安装过程中卡在"Installing requirements"阶段的问题。从日志中可以看到，系统在尝试安装xformers库时停滞不前，导致整个安装流程无法继续。

根本原因分析

经过技术排查，这个问题主要与ControlNet扩展的兼容性有关。ControlNet作为Stable Diffusion WebUI的一个重要扩展，其依赖关系可能会与主程序的安装过程产生冲突。特别是在安装xformers这个用于加速推理的库时，这种冲突表现得尤为明显。

解决方案

1. 删除ControlNet扩展文件夹：这是最直接的解决方法。进入WebUI的extensions目录，找到ControlNet相关的文件夹并将其删除，然后重新运行安装程序。

2. 手动安装xformers：如果问题仍然存在，可以尝试先手动安装xformers库：

   pip install xformers
   

   然后再运行WebUI的安装脚本。

3. 使用干净的Python环境：创建一个全新的Python虚拟环境，确保没有残留的旧版本库影响安装过程。

预防措施

1. 在安装新版本WebUI前，建议先备份extensions目录
2. 定期清理不再使用的扩展
3. 关注官方更新日志，了解已知的兼容性问题

技术建议

对于开发者而言，建议在安装脚本中加入更完善的错误处理机制，特别是对于xformers这类关键依赖的安装过程。可以考虑：

• 增加超时检测
• 提供更详细的安装进度反馈
• 实现自动回滚机制

这个问题虽然看似简单，但它揭示了开源项目中依赖管理的重要性。随着Stable Diffusion生态系统的不断扩大，如何平衡功能扩展与系统稳定性将成为开发者需要持续关注的重点。