安装Django项目依赖出现asgiref版本冲突报错如何解决

问题根因 #

安装失败的核心原因是硬编码的依赖版本不兼容：requirements.txt中强制指定asgiref==3.2.5，但当前锁定的Django==3.1.14要求asgiref版本必须满足>=3.2.10,<4，3.2.5低于Django要求的最低依赖版本，pip无法同时满足两个版本约束，因此抛出ResolutionImpossible错误终止安装。

可落地修复方式 #

按推荐优先级从高到低排列：

• 最小改动修复（优先选）：直接修改requirements.txt第一行的asgiref版本，将asgiref==3.2.5替换为asgiref==3.2.10，该版本完全符合Django 3.1.14的依赖要求，不会触发其他包的兼容问题。修改完成后重新执行pip install -r requirements.txt即可正常安装。
• 自动解析修复：直接删除requirements.txt中asgiref==3.2.5整行内容，pip在依赖解析阶段会自动拉取适配Django版本的asgiref包。安装完成后可执行pip freeze > requirements.txt，将当前环境实际安装的兼容版本回写到依赖文件，固化运行环境配置。
• 版本降级修复：如果业务代码强依赖asgiref==3.2.5无法升级，可将Django==3.1.14替换为Django==3.0.14（Django 3.0系列最终稳定补丁版），该版本的asgiref依赖范围为>=3.2,<3.3，可完美适配asgiref 3.2.5。注意降级前需确认业务代码未使用Django 3.1版本新增的特性，避免运行时报错。

避坑提示：不要直接删除所有包的固定版本号让pip无约束解析依赖，当前依赖列表中的django-heroku、旧版stripe包都存在已知的跨版本兼容问题，全量放开版本锁会触发更多新的依赖冲突，优先选择最小改动的修复方式即可。

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