为何GitHub Actions构建的Docker镜像远大于本地构建？

核心原因：架构差异 #

你的MacBook Pro M1是ARM64架构，而GitHub Actions默认使用x86_64（AMD64）架构的虚拟机，两者的底层镜像与依赖包体积存在明显差异：

• Python官方slim镜像在ARM64下体积更小；
• 大量Python第三方包的预编译二进制包（wheels）在x86_64下体积更大，部分包甚至需要从源码编译，额外引入编译依赖（如gcc、make等），若未清理编译缓存会进一步增大镜像体积。

额外问题：Dockerfile语法错误 #

你的Dockerfile存在明显语法错误：COPY . /app被误写进RUN命令末尾，导致COPY操作未执行，反而让poetry install接收了无效参数。正确写法应拆分COPY为单独命令：

FROM python:3.11-slim AS builder

WORKDIR /app

RUN pip install poetry

COPY pyproject.toml poetry.lock /app/

RUN poetry config virtualenvs.create false \
    && poetry install --no-dev --no-interaction --no-ansi

# 单独拆分COPY命令
COPY . /app

CMD ["python3", "main.py" ]

该错误可能在本地构建时被你无意中修正，而GitHub Actions执行了错误的Dockerfile，导致镜像包含不必要的冗余内容。

让GitHub Actions构建镜像与本地体积一致的方法 #

1. 指定ARM64架构构建（推荐） #

在GitHub Actions中使用buildx指定与本地一致的ARM64架构构建：
修改workflow中的构建步骤：

- name: Set up Docker Buildx
  uses: docker/setup-buildx-action@v3

- name: Build Docker image
  run: docker buildx build --platform linux/arm64 -t ghcr.io/${{ github.repository_owner }}/${{ github.repository }}/${{env.IMAGE_NAME}}:latest --load .

--platform linux/arm64确保构建出的镜像架构与M1本地一致，依赖包和基础镜像体积会匹配本地结果。

2. 优化Dockerfile清理冗余内容 #

即使在x86_64架构下，也可通过多阶段构建减小镜像体积：

# 构建阶段
FROM python:3.11-slim AS builder

WORKDIR /app

# 安装poetry并清理缓存
RUN pip install poetry --no-cache-dir \
    && rm -rf /root/.cache/pip

COPY pyproject.toml poetry.lock /app/

# 安装依赖并清理缓存
RUN poetry config virtualenvs.create false \
    && poetry install --no-dev --no-interaction --no-ansi \
    && rm -rf /root/.cache/pip \
    && rm -rf /root/.cache/pypoetry

# 运行阶段
FROM python:3.11-slim

WORKDIR /app

# 从构建阶段复制依赖和代码
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY --from=builder /usr/local/bin /usr/local/bin
COPY . /app

CMD ["python3", "main.py" ]

多阶段构建会将构建过程中的临时文件（如poetry安装包、编译缓存）排除在最终镜像外，大幅压缩体积。

3. 验证镜像架构 #

构建完成后可添加步骤验证架构是否匹配：

- name: Check image architecture
  run: docker inspect ghcr.io/${{ github.repository_owner }}/${{ github.repository }}/${{env.IMAGE_NAME}}:latest | grep Architecture

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