必须先 COPY composer.json/composer.lock,才能利用 Docker 构建缓存:若顺序颠倒,任意源码变动都会使依赖安装层失效,导致每次构建都重装,CI 时间从20秒飙升至3分钟以上。

多阶段构建中,composer install 本身不直接支持 VCS(如 Git)缓存,但 Docker 层缓存 + Composer 全局缓存可显著减少重复 clone 和下载——关键在于让 composer install 复用已有的 vendor 或 ~/.composer/cache,而不是每次都从头拉取。
为什么 COPY composer.json/composer.lock 必须放在 RUN composer install 之前
Docker 构建缓存生效的前提是:上一层的文件内容完全一致。如果先 COPY . . 再 RUN composer install,只要任意源码文件变动,整个依赖安装层就会失效,哪怕 composer.lock 没变。
-
composer.json和composer.lock必须单独COPY,且必须早于任何其他代码复制 - 顺序错误会导致每次
git commit都触发完整重装,CI 构建时间从 20 秒飙升到 3 分钟+ - 若项目使用私有 Git 包(如
"monolog/monolog": "dev-main as 2.10.0"),Docker 缓存仍有效,但需确保 SSH key 或 token 不参与该层(应通过--secret挂载)
如何在多阶段构建中复用 Composer 全局缓存
Composer 默认把下载的 dist 包和 VCS 克隆缓存在 ~/.composer/cache。在多阶段构建中,这个目录默认不跨阶段保留,但可通过 BUILDKIT 的 --mount=type=cache 显式挂载。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 启用 BuildKit:
DOCKER_BUILDKIT=1 docker build . - 在
RUN composer install前加挂载声明:RUN --mount=type=cache,id=composer-cache,target=/root/.composer/cache composer install --no-dev --optimize-autoloader - 该挂载对同一
id的所有构建共享,CI 中多个 job 可复用同一缓存池(需配置远程 cache backend) - 注意:Alpine 镜像中
/root可能不可写,建议改用target=/home/cache并配USER切换
私有 Git 包导致反复 clone 的真实原因
不是缓存没生效,而是 Composer 在解析 composer.lock 时发现 package 的 source 类型为 vcs,且 reference(如 commit hash)未命中本地克隆副本,就会强制 git clone —— 即使缓存里已有 zip 包。
- 现象:
Cloning into '/tmp/composer_cache/vcs/https---git.example.com-myprivaterepo.git/'...每次都出现 - 解决:在
composer install加--prefer-dist(默认已启用),强制跳过 VCS clone,优先用 dist 包 - 若必须用 VCS(如调试 dev 分支),可在
composer.json中显式设"preferred-install": {"myprivaterepo/*": "source"},但要接受 clone 开销 - 更稳方案:CI 中预生成 dist 包并托管到内部 HTTP 源,再通过
repositories指向它
alpine 镜像下 Git 缓存失效的隐藏陷阱
Alpine 镜像默认不带 git,但 Composer 遇到 VCS 包时会 fallback 到 git 下载。若你在构建阶段临时 apk add git,Git 的全局配置(如 core.autocrlf、init.defaultBranch)可能影响 clone 行为,导致缓存 hash 不一致。
- 现象:同一 commit,两次构建生成的
vendor/目录stat时间戳不同,破坏后续层缓存 - 修复:在
apk add git后立即运行git config --global core.autocrlf false && git config --global init.defaultBranch main - 更推荐:彻底避免 Alpine 上跑 VCS 操作,改用
--prefer-dist+ 内部 dist 源,或换用php:8.3-cli(Debian)基础镜像
真正卡住构建速度的往往不是网络,而是缓存没对齐:Docker 层、Composer cache、Git 配置三者任一错位,都会让本该秒级完成的依赖安装变成分钟级。检查点永远是这三处——composer.lock 是否被最早复制、--mount=type=cache 是否启用、--prefer-dist 是否明确指定。

















