You need to enable JavaScript to run this app. 克隆Django项目安装依赖时出现websockets版本冲突如何解决
优惠活动
大模型
产品
解决方案
定价
更多

克隆Django项目安装依赖时出现websockets版本冲突如何解决

克隆Django项目依赖版本冲突解决方案

冲突成因说明

当前的版本矛盾来自两个无法同时满足的硬版本锁定要求:

  • requirements.txt第44行手动锁定的websockets==7.0
  • 项目依赖的django-private-chat 0.3.0强制声明需要websockets==8.1
    之前手动安装websockets==8.1后仍报错的核心原因是,执行pip install -r requirements.txt时,pip会遍历全量清单的硬锁定规则,自动将不匹配的版本替换回清单指定的版本,单独手动安装的操作无法覆盖requirements.txt的强制校验逻辑。

可落地修复步骤

  • 第一步:修改requirements.txt锁定版本
    定位到文件第44行的websockets==7.0条目,直接替换为websockets==8.1。不要直接删除该行的版本号,因为django-private-chat 0.3.0对websockets的版本要求是强绑定的,放宽版本范围反而可能拉取更高不兼容的版本,触发新的运行时错误。
  • 第二步:清理虚拟环境内的残留依赖
    激活项目专属的Python虚拟环境后,执行命令:
    pip uninstall websockets django-private-chat -y
    将两个存在版本关联的包从环境中完全移除,避免pip缓存的旧版本干扰后续安装流程。
  • 第三步:重新执行全量依赖安装
    运行标准安装命令:
    pip install -r requirements.txt
    此时pip校验到requirements.txt里的websockets版本已经和django-private-chat的依赖要求对齐,不会再抛出版本冲突报错。
  • 第四步:安装完成后做兼容性校验
    执行校验命令:
    pip check
    当输出No broken requirements found时,说明当前环境的所有依赖版本完全匹配,没有残留的冲突问题。

避坑提示

  • 所有操作必须在项目专属的激活后的虚拟环境内执行,不要在全局Python环境操作,避免污染全局包版本引发其他项目异常。
  • 不要为了快速绕过冲突给pip安装命令加--ignore-installed或--force-reinstall参数,这类操作会随意覆盖关联依赖的版本,后续运行Django项目时会出现随机的模块导入错误。
  • 对于带硬版本锁定的requirements.txt,单独手动安装某一个依赖的操作是无效的,全量安装流程一定会按照清单的规则拉取对应版本,只有先修改清单内的冲突条目,才能从根源解决问题。

内容的提问来源于stack exchange,提问作者Guillermina Martinez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 23:54:05