M1用户求助：Automatic1111 WebUI更新后无法启动

问题情况 #

最近更新了Automatic1111的WebUI，M1芯片的Mac启动web服务器时一直陷入模块找不到的错误循环，启动脚本时的报错如下：

Traceback (most recent call last):
File "/Users/wesley/Documents/stable-diffusion-webui/stable-diffusion-webui/webui.py", line 7, in
from fastapi import FastAPI
ModuleNotFoundError: No module named 'fastapi'
(web-ui) wesley@Wesleys-MacBook-Air stable-diffusion-webui %

已经尝试过以下操作但均无效：

• 用pip和conda安装报错提及的所有模块
• 清理环境、彻底重装整个WebUI
• 运行项目issue区里的相关脚本

实用解决方法 #

1. 确认虚拟环境激活正确 #

很多时候手动安装模块时，没激活WebUI对应的虚拟环境，导致模块装到了全局环境里，WebUI无法识别：

• 进入WebUI目录，重新激活虚拟环境：

  source web-ui/bin/activate
  

  （如果是自动生成的venv环境，替换为source venv/bin/activate）
• 激活成功后，要么直接运行启动脚本，要么用pip安装缺失模块：

  pip install fastapi
  

2. 使用M1专属启动脚本 #

WebUI针对Apple Silicon提供了专属启动脚本，可自动适配环境和依赖：

• 在WebUI目录下先运行：

  ./webui-macos-env.sh
  

• 完成后再执行启动命令：

  ./webui.sh
  

3. 确保使用arm64版本的Python和pip #

M1芯片如果用Rosetta转译的Python，容易出现依赖兼容问题，需切换到原生arm64版本：

• 检查Python架构：

  python3 -c "import platform; print(platform.machine())"
  

  输出应为arm64，若显示x86_64说明用了转译，需从Python官网重新下载arm64版本安装
• 用原生pip重新安装所有依赖：

  pip3 install -r requirements.txt
  

4. 暂时降级到稳定版本 #

如果是本次更新导致的兼容性问题，可回退到之前能正常运行的版本：

• 通过git回退到M1用户验证过的稳定版本（需替换为具体的commit哈希值）：

  git checkout <commit-hash>
  

• 回退后重新安装依赖并启动服务

内容的提问来源于stack exchange，提问作者Wesley Clay Swank