### 解决 Python 环境中 uvicorn ModuleNotFoundError 错误 在解决 `ModuleNotFoundError: No module named 'uvicorn'` 问题时，需要明确以下关键点：Python 环境配置、模块安装路径与可执行文件的关系。 #### Python 环境中的模块安装路径 当使用 `pip` 安装模块时，模块会被放置到当前 Python 解释器的 `site-packages` 目录下。如果系统中有多个 Python 版本或虚拟环境，则需要确保 `pip` 和运行代码的 Python 解释器属于同一环境[^1]。可以通过以下命令验证： ```bash python -m pip show uvicorn ``` 此命令会显示 `uvicorn` 的安装路径以及所属 Python 环境的信息。如果未找到该模块，则需要重新安装： ```bash python -m pip install uvicorn ``` #### 可执行文件与模块的关系 通过 `which uvicorn` 查找到的可执行文件是 `uvicorn` 提供的一个命令行工具，它实际上是一个 Python 脚本，依赖于 `uvicorn` 模块。如果 Python 解释器无法找到 `uvicorn` 模块，即使存在可执行文件，也会报错 `ModuleNotFoundError`。因此，确保模块已正确安装在运行时环境中至关重要。 #### 验证和修复环境配置 为了验证 Python 环境是否正确配置，可以检查 `sys.path` 中是否包含 `uvicorn` 的安装路径： ```python import sys print(sys.path) ``` 如果安装路径不在 `sys.path` 中，则需要调整环境变量 `PYTHONPATH` 或重新安装模块到正确的环境。 #### systemd 配置中的环境问题 如果通过 systemd 启动服务时出现 `ModuleNotFoundError`，可能是由于 systemd 使用的环境变量与开发环境不同。可以在 systemd 配置文件中显式指定环境变量： ```ini Environment="PATH=/home/user/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" Environment="PYTHONPATH=/path/to/your/virtualenv/lib/python3.x/site-packages" ``` 然后重新加载并启动服务： ```bash sudo systemctl daemon-reload sudo systemctl restart uvicorn.service ``` #### 示例：systemd 配置文件 以下是一个完整的 systemd 配置文件示例，确保环境变量和路径正确设置： ```ini [Unit] Description=Uvicorn service for FastAPI application After=network.target [Service] User=user Group=user WorkingDirectory=/home/user/myapp Environment="PATH=/home/user/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" Environment="PYTHONPATH=/home/user/.local/lib/python3.x/site-packages" ExecStart=/home/user/.local/bin/uvicorn app.main:app --host 0.0.0.0 --port 8000 [Install] WantedBy=multi-user.target ``` #### pip 安装的包与可执行文件的区别 通过 `pip` 安装的包通常包含两部分：模块和可执行文件。模块是 Python 代码的核心部分，而可执行文件是方便用户直接调用的命令行工具。例如，`uvicorn` 的模块用于支持 Web 服务器功能，而 `uvicorn` 可执行文件是一个入口脚本，用于启动服务器。两者必须协同工作，缺少任何一个都会导致功能不完整。 ---