使用python-3.10-alpine构建Docker镜像时遭遇兼容性问题

问题分析 #

你遇到的错误核心是：numpy 1.21.x系列对Python 3.10的支持不完善。numpy 1.21版本发布于Python 3.10正式版之前，后续的1.21.6小版本虽尝试适配，但在Alpine这种轻量环境下，因缺少编译依赖或预编译包适配问题，仍会触发兼容性报错。另外你指定的numpy==1.21.2，但安装pandas 1.4.4时，pip可能会自动升级numpy到1.21.6（满足pandas的依赖约束），进而触发该错误。

解决方案 #

1. 升级numpy到支持Python 3.10的版本

修改requirements.txt，将numpy版本升级到1.22.0及以上（numpy 1.22是首个正式支持Python 3.10的稳定版本），同时修正pyrrow的拼写错误（应为pyarrow）：

numpy>=1.22.0
dask==2021.9.1
pandas==1.4.4
pyarrow==8.0.0

说明：pandas 1.4.4的依赖要求是numpy>=1.21.0且<1.24.0，升级到1.22.x完全兼容。

2. 修复基础镜像拼写错误

你的Dockerfile中python:3.10-apine是拼写错误，正确镜像名为python:3.10-alpine。

3. 补充Alpine环境的编译依赖

Alpine镜像默认缺少编译Python扩展包所需的系统依赖，安装numpy、pandas前需先安装这些依赖，安装完成后可清理以减小镜像体积。修改后的Dockerfile如下：

FROM python:3.10-alpine

# 安装编译依赖
RUN apk add --no-cache gcc musl-dev linux-headers

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 清理系统依赖（可选，减小镜像体积）
RUN apk del gcc musl-dev linux-headers

验证 #

修改后重新执行docker build .，即可正常完成依赖安装。

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