No module named 'optimum.onnxruntime'
🚨 错误信息
Python 3.11.9 (tags/v3.11.9:de54cf5, Apr 2 2024, 10:12:12) [MSC v.1938 64 bit (AMD64)]
Version: v1.10.1-amd
Commit hash: b51275bb3e36ababec34532ac81eb8014ea11199
no module 'xformers'. Processing without...
no module 'xformers'. Processing without...
F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\python\Lib\site-packages\pytorch_lightning\utilities\distributed.py:258: LightningDeprecationWarning: `pytorch_lightning.utilities.distributed.rank_zero_only` has been deprecated in v1.8.1 and will be removed in v2.0.0. You can import it from `pytorch_lightning.utilities` instead.
rank_zero_deprecation(
Launching Web UI with arguments: --skip-torch-cuda-test --use-directml --medvram --theme dark --opt-sub-quad-attention --precision full --upcast-sampling --no-half-vae --api --autolaunch --skip-python-version-check
Traceback (most recent call last):
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\launch.py", line 48, in <module>
main()
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\launch.py", line 44, in main
start()
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\modules\launch_utils.py", line 681, in start
import webui
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\webui.py", line 13, in <module>
initialize.imports()
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\modules\initialize.py", line 35, in imports
from modules import shared_init
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\modules\shared_init.py", line 8, in <module>
from modules.zluda import initialize_zluda
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\modules\zluda.py", line 7, in <module>
from modules.onnx_impl.execution_providers import available_execution_providers, ExecutionProvider
File "F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\modules\onnx_impl\__init__.py", line 6, in <module>
import optimum.onnxruntime
ModuleNotFoundError: No module named 'optimum.onnxruntime'
🤖 AI解决方案
错误翻译
原文：ModuleNotFoundError: No module named 'optimum.onnxruntime'
译文：模块未找到错误：没有名为 'optimum.onnxruntime' 的模块
原因分析
这是在使用 Stable Diffusion WebUI 启动时发生的 Python 模块导入错误。
根本原因：
运行环境缺少必要的 optimum.onnxruntime Python 包，这是 ONNX 模型推理所需的关键依赖。
具体位置：
sd-webui-aki-v4.11.1-cu128 项目的启动过程中F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128\modules\onnx_impl\__init__.py，第6行optimum.onnxruntime 但找不到该模块解决方案
根据您的运行环境，选择以下方案：
方案1：使用 pip 安装缺少的包（推荐）
bash
使用WebUI自带的Python环境
cd F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128
python -m pip install optimum[onnxruntime] --upgrade
方案2：如果方案1失败，安装完整依赖
bash
安装完整版本的optimum和onnxruntime
cd F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128
python -m pip install optimum onnxruntime --upgrade
方案3：安装CUDA版本（如果使用NVIDIA GPU）
bash
针对NVIDIA GPU用户
python -m pip install optimum[onnxruntime-gpu] --upgrade
️ 预防措施
1. 依赖管理最佳实践
bash
python -m venv venv
venv\Scripts\activate # Windows
2. 自动依赖检查
bash
cd F:\BaiduNetdiskDownload\sd-webui-aki-v4.11.1-cu128\sd-webui-aki-v4.11.1-cu128
python -c "import optimum.onnxruntime; print('所有依赖正常！')"
3. ️ 推荐工具
pip check：检查已安装包之间的兼容性pip list：查看已安装的包及其版本，确保 optimum 和 onnxruntime 都存在---
注意：安装完成后，重新运行 launch.py 即可启动 Stable Diffusion WebUI。如果还有其他依赖问题，会继续报出类似的模块未找到错误，请逐一安装缺少的包。