树莓派上无法构建Python Docker容器的问题咨询

Docker构建在Mac和树莓派上出现差异的核心原因是CPU架构不同：你的Mac是x86_64架构，树莓派是ARM架构（通常为armv7或aarch64）。python:3.11-slim-bookworm镜像在不同架构下的底层环境存在差异，pip安装依赖时，x86架构能找到预编译的ninja wheel包，无需从源码编译；而ARM架构缺少对应预编译包，pip需要源码编译ninja，但你的Debian slim镜像里缺少编译所需的构建工具，因此报错。

你在Mac上成功是因为x86架构有现成的预编译wheel，跳过了源码编译步骤；树莓派则必须编译源码，但依赖缺失导致失败。

以下两种方案任选其一，解决ARM架构下的编译依赖问题：

方案1：直接安装系统版ninja-build（推荐） #

在apt-get install步骤中加入ninja-build，让pip优先使用系统已安装的ninja，避免源码编译：

# We use Debian to be able to install pygobject
FROM python:3.11-slim-bookworm

# Download latest listing of available packages:
RUN apt-get -y update && \
    apt-get -y upgrade && \
    # 加入ninja-build及其他必要依赖
    apt-get -y install libdbus-glib-1-dev libgirepository1.0-dev libcairo2-dev ninja-build && \
    # 清理apt缓存减小镜像体积
    apt-get clean && rm -rf /var/lib/apt/lists/*

WORKDIR /backend

COPY ./requirements.txt /backend/requirements.txt

# Install Python dependencies
RUN pip3 install --no-cache-dir --upgrade -r /backend/requirements.txt

# Add backend folder to container
COPY ./ /backend

# Run the backend server on port 5000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "5000"]

方案2：安装完整构建工具链 #

如果后续还有其他包需要源码编译，可以安装build-essential（包含gcc、make等基础构建工具）：

# We use Debian to be able to install pygobject
FROM python:3.11-slim-bookworm

# Download latest listing of available packages:
RUN apt-get -y update && \
    apt-get -y upgrade && \
    # 加入构建工具及必要依赖
    apt-get -y install libdbus-glib-1-dev libgirepository1.0-dev libcairo2-dev build-essential && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

WORKDIR /backend

COPY ./requirements.txt /backend/requirements.txt

# Install Python dependencies
RUN pip3 install --no-cache-dir --upgrade -r /backend/requirements.txt

# Add backend folder to container
COPY ./ /backend

# Run the backend server on port 5000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "5000"]

• 合并RUN命令减少镜像层数，同时清理apt缓存可有效减小镜像体积
• 检查requirements.txt中的包版本，部分特定版本可能在ARM架构下没有预编译wheel，可尝试放宽版本约束或更换支持ARM的包版本

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