先分离依赖安装与代码复制，通过先拷贝composer.json和lock文件并安装依赖，使依赖层可缓存；只要这两文件不变，后续构建跳过install，提升效率。

在多阶段 Docker 构建中使用 Composer 时，缓存失效是一个常见问题。主要原因是每次构建都会重新安装依赖，即使 composer.json 和 composer.lock 没有变化。这会拖慢构建速度，浪费资源。根本原因在于 Docker 的层缓存机制对文件变更敏感，只要 COPY 或 ADD 命令涉及的文件发生变化，后续所有层都会重建。

理解缓存失效的原因

Docker 构建是分层的，每一层基于前一层。如果某一层的内容变化，其后的所有层都无法复用缓存。在 Composer 场景中，典型的问题出现在以下流程：

• COPY . /app —— 复制整个项目目录，包括开发配置、日志等无关文件
• composer install —— 安装依赖

即使只修改了 README.md，Docker 也会认为源码有变，导致 composer install 层无法命中缓存。

分离依赖安装与代码复制

关键思路是：先拷贝并安装依赖，再复制应用代码。这样只有当 composer.json 或 composer.lock 变化时，才重新安装依赖。

FROM php:8.2-cli as builder
WORKDIR /app
先只复制依赖声明文件
COPY composer.json composer.lock ./
安装依赖（这一层会被缓存）
RUN composer install --no-dev --optimize-autoloader --no-scripts --no-progress
复制其余代码
COPY . .
运行必要的脚本（如生成 autoload）
RUN composer dump-autoload --optimize
其他构建步骤...

这样做之后，只要 composer.json 和 composer.lock 不变，composer install 就会使用缓存层，大幅提升构建效率。

利用多阶段构建减少最终镜像体积

多阶段构建不仅能优化缓存，还能减小最终镜像体积。可以在一个阶段安装带 dev 的依赖进行测试或编译，另一个阶段只保留运行所需依赖。

FROM php:8.2-cli as vendor
WORKDIR /app
COPY composer.json composer.lock ./
RUN composer install --optimize-autoloader --no-progress
FROM php:8.2-cli as production
WORKDIR /app
COPY composer.json composer.lock ./
从上一阶段复制已安装的 vendor
COPY --from=vendor /app/vendor ./vendor
COPY . .
CMD ["php", "index.php"]

这样最终镜像不需要包含 dev 依赖，也不需要重新执行 install，避免了网络请求和重复计算。

确保精确匹配锁定文件

始终提交 composer.lock 文件，并在生产构建中使用它。否则 composer install 会重新解析依赖，破坏可重复性。

建议在 CI/CD 中添加检查：

• 运行 composer install --dry-run 确认 lock 文件是最新的
• 禁止在没有 lock 文件的情况下构建生产镜像

基本上就这些。核心是合理组织 COPY 顺序，把不变或少变的文件提前处理，让 Docker 缓存真正发挥作用。不复杂但容易忽略。