笙亿网络策划

Docker Compose 多阶段构建怎么优化？怎么减少最终镜像体积？

约 6 分钟读完 28 阅
文章导读
通过多阶段构建配合缓存优化策略，可将 Docker 镜像体积从 1.2GB 降至约 150MB，缩减近 90%，同时构建时间从十几分钟降低到 1 分钟左右，效率提升约 10 倍。
📋 目录
  1. 一 原因分析
  2. 二 解决方案
  3. 三 注意事项
  4. 四 参考来源
A A

Docker Compose 多阶段构建怎么优化？怎么减少最终镜像体积？

通过多阶段构建配合缓存优化策略，可将 Docker 镜像体积从 1.2GB 降至约 150MB，缩减近 90%，同时构建时间从十几分钟降低到 1 分钟左右，效率提升约 10 倍。

原因分析

Docker 镜像体积臃肿的核心原因在于传统构建方式将所有构建工具和依赖项打包进最终镜像。根据 2025 年 9 月 7 日发布的技术分析，传统 Dockerfile 通常包含所有构建和运行环境，例如 Node.js 应用镜像体积往往超过 1GB，因为镜像中包含了 npm、构建工具、源代码以及开发依赖等生产环境不需要的内容。多阶段构建通过在一个 Dockerfile 中使用多个 FROM 指令，每个阶段基于不同的基础镜像，将构建环境与运行环境天然隔离，最终仅复制必要文件到生产镜像中。

解决方案

1. 使用多阶段构建分离构建与运行环境

在 Dockerfile 中定义至少两个阶段：builder 阶段使用完整镜像处理依赖安装和编译，final 阶段使用精简镜像仅复制运行所需文件。以 PHP+Composer 为例（2025 年 12 月 17 日资料）：

# 构建阶段
FROM php:8.2-cli AS builder
WORKDIR /app
COPY composer.json composer.lock ./
RUN --mount=type=cache,id=composer-cache,dest=/root/.composer/cache \
    composer install --no-dev --optimize-autoloader --classmap-authoritative
COPY . .

# 生产阶段
FROM php:8.2-cli-alpine
WORKDIR /app
COPY --from=builder /app/vendor ./vendor
COPY --from=builder /app/autoload.php ./
COPY . .

Java Spring Boot 应用同样适用（2025 年 12 月 30 日资料）：使用 maven:3.8.6-openjdk-11 作为 builder 阶段，最终镜像切换到 openjdk:11-jre-slim，镜像体积从 800MB 降至 150MB。

2. 启用 BuildKit 缓存挂载

启用 BuildKit 后，使用 RUN --mount=type=cache 让 Composer 或 npm 自动复用缓存，无需手动管理缓存目录。在 Dockerfile 开头添加# syntax=docker/dockerfile:1 声明新版语法，然后使用：

Docker Compose 多阶段构建怎么优化？怎么减少最终镜像体积？
RUN --mount=type=cache,id=composer-cache,dest=/root/.composer/cache \
    composer install --no-dev --optimize-autoloader

根据 2025 年 9 月 11 日发布的 Docker Compose 镜像构建最佳实践，通过缓存优化可将构建时间缩短 70%。BuildKit 会自动跨构建复用该 cache ID，且不会把 cache 目录打进镜像层。

3. 选择轻量级基础镜像

将基础镜像从标准版替换为 Alpine 或 Slim 版本。2025 年 9 月 7 日的测试数据显示，将 node:16 替换为 node:16-alpine，基础镜像体积从 300MB+ 减少到 5MB 左右。对于 PHP 应用，使用 php:8.2-cli-alpine 替代 php:8.2-cli 可显著减小最终镜像体积。

4. 优化依赖安装顺序提升缓存命中率

先 COPY composer.json 和 composer.lock（或 package*.json），执行依赖安装，再 COPY 源代码。这样如果源码变了但依赖没变，Docker 会利用缓存跳过下载步骤。2025 年 12 月 30 日的 Java 最佳实践明确指出：先只拷贝 pom.xml 下载依赖，再拷贝源码开始打包，这样如果源码变了但依赖没变，Docker 会利用缓存。

注意事项

根据 2025 年 12 月 17 日和 2024 年 11 月 15 日的实际用户反馈，以下是常见踩坑点：

Docker Compose 多阶段构建怎么优化？怎么减少最终镜像体积？
  • 不要在 final 阶段 RUN composer install 或 npm install——这会让 composer 下载器、临时 zip 解压文件、未清理的.git 目录等全留在镜像里，导致镜像体积膨胀
  • 不要 COPY . /app 包含 composer.json/lock 在内再 install——应先 COPY lock+json，再 install，再 COPY 代码，保证 vendor 层可缓存
  • 检查最终镜像是否含/root/.composer、/tmp/composer*、vendor/bin/*（除非真需要）——可在 final 阶段用 RUN rm -rf /root/.composer /tmp/*清理，但更推荐从源头规避
  • 使用 docker-slim 等工具分析镜像内容，删除不必要的文件；区分开发与生产环境镜像；定期清理无用镜像
  • 在 CI/CD 流水线中加入镜像大小检查，确保优化效果持续有效

参考来源

来源：阿里云开发者社区 - 优化 Dockerfile 实现 Docker 镜像构建加速与体积缩减（2024 年 11 月 15 日）

来源：Docker 技术文档 - 多阶段构建优化镜像大小实践（2025 年 9 月 7 日）

来源：PHP Docker 最佳实践 - 如何在多阶段 Docker 构建中优化 Composer 缓存层（2025 年 12 月 17 日）

来源：企业级容器化指南 - Docker Compose 镜像构建最佳实践（2025 年 9 月 11 日）