使用python:3.9-alpine镜像CI安装psycopg2==2.9.1报错原因问询

根因分析 #

• CI配置的系统依赖安装命令语法错误
  你在.gitlab-ci.yml的before_script字段中，错误地将apk update和apk add两个独立命令拼接为一行，导致postgresql-dev、musl-dev等psycopg2编译必需的系统依赖没有被正确安装。pip拉取psycopg2源码后编译时缺少对应头文件，直接返回失败，pip就会判定该版本不可用。
• Alpine系统的C库兼容限制
  PyPI官方提供的psycopg2、psycopg2-binary预编译包均基于glibc标准库构建，而python:3.9-alpine镜像使用的是musl libc，没有兼容的预编译二进制包可用，pip只能拉取源码本地编译，编译失败就会触发「找不到匹配版本」的报错，哪怕版本列表中明确展示了目标版本。

修复步骤 #

1. 修正CI配置中的apk命令，拆分命令并补全必要编译依赖：

before_script:
  - pip install --upgrade pip setuptools wheel
  # 拆分独立命令，补全gcc等编译工具
  - apk update
  - apk add -q --no-cache postgresql-dev musl-dev gcc python3-dev libpq
  - pip install -r requirements/production.txt --no-cache

2. 若仍有报错，可将依赖中的psycopg2==2.9.1替换为psycopg2-binary==2.9.1，配合上述系统依赖即可正常安装。

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