M1芯片Mac构建Ubuntu Docker镜像时Pandas依赖安装失败求助

问题根源 #

M1 Mac采用arm64架构，Docker默认会基于arm64构建ubuntu:20.04镜像（或以arm64模式运行容器）。你指定的pandas-0.24.0-cp38-cp38-linux_x86_64.whl是针对x86_64架构的包，和容器的arm64架构不兼容，因此触发安装失败错误。而CI/CD的Linux机器本身是x86_64架构，能完全匹配wheel包，所以正常运行。

解决方案 #

1. 强制以x86_64平台构建镜像（推荐）

利用Docker的--platform参数，强制指定构建和运行的平台为linux/amd64，Docker会通过Rosetta 2模拟x86_64环境，完美匹配你指定的wheel包：

docker build --platform linux/amd64 -t your-target-image .

运行容器时也建议加上该参数，避免架构不匹配：

docker run --platform linux/amd64 your-target-image

2. 调整Poetry配置适配arm64架构

如果不需要严格使用预编译的x86_64 wheel，可以修改配置让Poetry自动适配arm64环境：

• 首先在Dockerfile中添加pandas源码编译所需的依赖：

  RUN apt-get update && apt-get install -y gcc gfortran python3-dev libopenblas-dev
  

• 编辑pyproject.toml，移除针对x86_64 wheel的指定配置，让Poetry根据容器架构自动选择安装方式（无对应arm64 wheel时会自动从源码编译）。

3. 强制pip使用x86_64 wheel（备选）

如果必须指定该x86_64 wheel，可以在安装时给pip添加平台参数：

RUN poetry run pip install --platform linux_x86_64 --only-binary :all: --no-deps pandas==0.24.0

这种方式需要手动处理pandas的所有依赖包，确保它们也提供x86_64版本的wheel，否则会出现依赖缺失问题，因此仅作为备选方案。

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