自定义pip包安装时提示无法找到匹配的aiohttp分发版本

核心原因 #

该报错本质是pip无法在当前运行环境下找到适配的aiohttp发行包，可按以下步骤排查解决：

1. 修正setup.py配置，限定Python版本范围 #

aiohttp 3.x 要求Python版本 >= 3.7，你当前的配置仅标注支持Python 3，未限定最低版本，若安装用户使用Python 3.6及以下版本，就会出现找不到匹配aiohttp版本的报错。
修改方案：

• 在classifiers列表中补充明确的Python支持版本：

classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Education",
    "Operating System :: OS Independent",
    "License :: OSI Approved :: MIT License",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.7",
    "Programming Language :: Python :: 3.8",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
]

• 在setup参数中添加python_requires字段，强制要求最低Python版本：

setup(
    # 其他原有参数不变
    python_requires=">=3.7",
    install_requires=requirements,
    include_package_data=True
)

修改完成后升级版本号，重新打包上传到PyPI即可避免低版本用户误装触发报错。

2. 引导安装用户排查本地环境 #

• 升级本地pip到最新版本，执行命令：
  pip install --upgrade pip
• 若使用自定义镜像源，可临时切换官方源尝试安装，避免源同步不全导致找不到包。
• 若使用冷门硬件架构（如老旧ARM、嵌入式设备），需先安装对应C语言编译工具链，再尝试安装，此时pip会自动从源码编译适配的aiohttp版本。

3. 确认打包流程合规 #

你本地打包前需升级打包工具到最新版本，避免打包过程出现依赖丢失问题：
执行以下命令升级工具：
pip install --upgrade setuptools wheel twine
重新打包命令：
python setup.py sdist bdist_wheel
打包完成后使用twine上传新包到PyPI即可。

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