因为docker缓存从上到下逐层比对，若composer install放在copy . .之后，每次代码变更都会导致vendor重装；必须提前单独copy composer.json和composer.lock，再执行composer install，才能确保依赖层稳定复用。
为什么 composer install 层不能随便写在任意位置
Docker 构建缓存从上到下逐层比对，只要某一层的指令或输入文件变了，它和所有后续层都会失效。把 composer install 放在复制源码之后（比如 COPY . . 后面），意味着每次改一行 PHP 代码，整个 vendor/ 都得重装——哪怕 composer.lock 完全没变。
真正要缓存的，只是依赖本身；而源码变更不该影响依赖安装结果。
- 必须把
composer.json和composer.lock提前COPY到镜像中，且放在composer install指令之前 - 不要
COPY整个项目后再跑composer install，否则缓存永远无法命中 - 如果项目用了自定义 Composer 插件或私有包，确保
auth.json也提前COPY（但生产环境更推荐用COMPOSER_AUTH环境变量注入）
如何让 composer install 层真正“最小”
最小化不是指命令字符数少，而是指该层内容稳定、体积小、复用率高。关键在于剥离无关干扰，只保留 vendor 目录生成所需的最小上下文。
- 使用
--no-dev --no-scripts --no-progress --optimize-autoloader，去掉开发依赖、跳过钩子脚本、关闭进度条、生成扁平类映射 - 加
--prefer-dist强制下载压缩包而非 Git 克隆，减少网络波动和解压开销 - 避免在
RUN中混用其他命令（如&&连写多个操作），否则任一子命令失败都会让整层失效 - 国内环境必须前置设置镜像源：
RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/，否则首次运行会卡在 DNS 解析
Alpine 镜像里 composer install 报 SSL 错误怎么办
SSL certificate problem: unable to get local issuer certificate 不是证书过期，而是 Alpine 默认不带 CA 根证书包。官方 PHP Alpine 镜像（如 php:8.3-cli-alpine）没有预装 ca-certificates，导致 Composer 连不上 HTTPS 镜像源。
- 必须在
composer install前加：RUN apk add --no-cache ca-certificates - 别信“某些基础镜像已自带”，2026 年主流 Alpine 版本仍需显式安装
- 如果还报错，检查是否漏了
openssl：Alpine 下部分 PHP 扩展（如ext-openssl）需手动启用，docker-php-ext-enable openssl可能必要
多阶段构建中 vendor 复制后还要再 dump-autoload 吗
要，而且必须在最终运行镜像里执行一次 composer dump-autoload --optimize。第一阶段安装时的 --optimize-autoloader 生成的是基于当时路径的映射，复制到新镜像后，vendor/autoload.php 中的路径可能失效（尤其跨镜像基础路径不同，比如 /app → /var/www/html）。
- 第二阶段复制
vendor/后，应补一句：RUN composer dump-autoload --optimize --classmap-authoritative - 别省略
--classmap-authoritative，它强制 Autoloader 只查 classmap，跳过文件扫描，性能更好也更确定 - 如果最终镜像没装 Composer，就别这么干——得在第一阶段就把 autoload.php 生成好再复制，或者用
php -d memory_limit=-1 vendor/bin/composer dump-autoload ...显式调用
composer.lock 文件本身的平台声明（platform 字段）是否与目标镜像一致。PHP 小版本差一级（比如本地锁的是 8.3.5，镜像用的是 8.3.0），某些扩展 ABI 不兼容，composer install 就会静默跳过部分扩展依赖，直到运行时报 Class not found。
