Python 3.12环境下无法安装aiohttp的问题求助

问题重现 #

安装aiohttp时触发以下错误：

无法为aiohttp构建wheel，这是安装基于pyproject.toml的项目所必需的。
error: command 'C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.37.32822\bin\HostX86\x64\cl.exe' failed with exit code 2
ERROR: 构建aiohttp的wheel失败
构建aiohttp失败
错误：无法为aiohttp构建wheel，这是安装基于pyproject.toml的项目所必需的。

这类问题多出现于Python 3.12环境，核心原因是旧版aiohttp未适配Python 3.12的API变更，或者编译依赖缺失。

解决步骤 #

1. 安装适配Python 3.12的aiohttp版本 #

aiohttp从3.9.0版本开始正式支持Python 3.12，直接指定版本安装：

pip install aiohttp>=3.9.0

如果是通过其他依赖间接安装aiohttp，可在requirements.txt中强制指定版本：

aiohttp>=3.9.0

或执行升级命令覆盖旧版本：

pip install --upgrade aiohttp

2. 补全Windows编译依赖 #

若指定版本后仍报错，说明缺少C编译环境：

• 打开Visual Studio Installer，确保勾选**Desktop development with C++**组件，包含MSVC编译器、Windows SDK等核心工具
• 安装完成后重启终端，再尝试安装aiohttp

3. 直接安装预编译wheel（跳过源码编译） #

不想配置编译环境的话，可下载对应Python 3.12、Windows架构的aiohttp预编译wheel文件，本地安装：

pip install path/to/aiohttp-xxx-cp312-cp312-win_amd64.whl

4. 临时降级Python版本（备选方案） #

以上方法无效时，可暂时降级到Python 3.11，该版本对aiohttp旧版本兼容性更好，能正常完成安装。

内容的提问来源于stack exchange，提问作者mshojaei77