使用Pipenv升级Python版本时出现包安装错误的求助

问题背景 #

• 基于Pipenv管理的Django项目，原Python3.8环境下本地及Bitbucket流水线（python:3.8-slim镜像）运行正常，已更新所有依赖包。
• 升级Python3.9后：本地安装测试正常，但Bitbucket流水线执行pipenv install（Pipenv 2022.11.30）时所有包均报「An error occurred while installing 」。
• 测试Python3.10时：本地环境执行pipenv install也出现相同错误。
• 本地环境：M1芯片Macbook Pro，系统为最新版本。

解决步骤 #

1. 修正Pipfile版本配置 #

确保Pipfile的[requires]段准确指定目标Python版本，避免模糊匹配导致环境不一致：

[requires]
python_version = "3.9"
# 若需更严格控制，添加具体小版本
python_full_version = "3.9.16"

2. 清理缓存与旧虚拟环境 #

旧环境缓存会干扰新依赖安装，本地和流水线都需执行清理：

• 本地操作：

  pipenv --rm
  pipenv clean
  rm -rf ~/.local/share/virtualenvs/$(basename $(pwd))-*
  

• Bitbucket流水线添加前置清理步骤：

  script:
    - pipenv --rm || true  # 忽略环境不存在的错误
    - pipenv clean
    - pipenv install --deploy --ignore-pipfile
  

  使用--deploy严格遵循Pipfile.lock安装，--ignore-pipfile避免Pipfile与lock文件冲突。

3. 适配架构差异生成兼容lock文件 #

M1为ARM架构，Bitbucket流水线使用x86架构的python:3.9-slim，部分包无跨架构预编译轮子，需生成适配Linux x86的lock文件：

pipenv lock --platform linux_x86_64 --python 3.9

提交更新后的Pipfile.lock至仓库，让流水线直接使用预编译依赖。

4. 升级Pipenv版本 #

旧版Pipenv（2022.11.30）对Python3.9/3.10支持存在兼容问题，本地及流水线均升级至最新版：

• 本地：

  pip install --upgrade pipenv
  

• Bitbucket流水线前置升级：

  script:
    - pip install --upgrade pipenv
    - pipenv install --deploy
  

5. 补充流水线系统编译依赖 #

python:3.9-slim镜像缺失编译依赖，部分包（如psycopg2、pillow）需编译安装，先安装系统库：

script:
  - apt-get update && apt-get install -y gcc python3-dev libpq-dev libjpeg-dev
  - pipenv install --deploy

6. 检查依赖包的Python版本兼容性 #

Python3.10对旧版依赖兼容性要求更高，需确认所有包支持Python3.10：

• 比如Django需3.2及以上版本支持Python3.10，更新Pipfile中不兼容的包至最新兼容版本，重新生成lock文件。

内容的提问来源于stack exchange，提问作者Tobias Gårdner