Docker容器使用Python版本与指定不符，如何强制使用Python 3.7

你遇到的报错核心原因是Python 3.10起collections.Iterator被迁移到了collections.abc.Iterator，你使用的旧版Django不兼容Python3.10，必须严格锁死Python3.7版本，可按以下步骤操作：

• 第一步：锁死基础镜像的精确版本
  不要使用python:3.7这类浮动标签，浮动标签会命中本地缓存的旧镜像，必须指定完整的精确版本号甚至镜像哈希值，Dockerfile开头写法参考：

  # 写法1：指定精确小版本
  FROM python:3.7.16-slim-bullseye
  # 写法2：额外加镜像哈希，彻底避免标签更新导致的版本漂移，哈希可从DockerHub官方Python镜像页查询
  # FROM python:3.7.16-slim-bullseye@sha256:5f2b155394113a8132e679b80a3900497b3a076474e5c238424f5b2f5a9c7e1d
  

• 第二步：禁用构建缓存，彻底清理残留资源
  WSL2环境下Docker经常出现缓存清理不彻底的问题，每次修改版本后强制无缓存构建：

  • 单独构建镜像执行：docker build --no-cache -t 你的镜像名称 .
  • 使用docker-compose执行：docker-compose build --no-cache
  • 构建前可执行docker system prune -af清理所有未使用的镜像、容器、缓存层，注意提前备份需要的容器数据。

• 第三步：排查隐式的版本覆盖逻辑
  检查你手头的三个配置文件，避免有其他逻辑替换了Python版本：

  1. 检查docker-compose.yml是否设置了image字段指向其他带Python3.10的镜像，该字段优先级高于本地Dockerfile构建
  2. 检查docker-entrypoint.sh是否有安装python3.10、pyenv、conda等版本管理工具的逻辑，手动修改了默认python路径
  3. 检查构建上下文里是否有.python-version、runtime.txt等被构建脚本读取的配置文件，无意中指定了Python版本

• 第四步：添加版本校验逻辑，避免错误镜像生成
  在Dockerfile末尾添加版本校验命令，版本不符合直接终止构建，从根源避免生成错误版本的镜像：

  RUN python3 --version | grep -q "Python 3.7\." || (echo "Python版本不符合要求，构建终止" && exit 1)
  

  也可以把这段校验加到docker-entrypoint.sh的最开头，启动时就校验版本，不符合直接退出，不会运行错误版本的Django服务。

• 第五步：WSL2环境特殊处理

  1. 不要把Docker构建上下文放在Windows的NTFS分区（也就是WSL里的/mnt/c/、/mnt/d/这类路径），移到WSL2的ext4分区内，避免文件同步延迟导致构建时读取到旧的Dockerfile
  2. 如果问题还是反复出现，打开Docker Desktop设置，重置为出厂设置，清理所有跨环境残留的缓存数据。

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