答案：必须在run指令中用环境变量composer_repo_packagist显式设置镜像源，因其在当前层立即生效、不依赖持久化配置且避免多阶段构建中路径与用户权限问题；alpine镜像需先安装ca-certificates证书，copy顺序须确保composer.lock在composer install前被正确复制。
直接在 RUN 指令前设置 COMPOSER_REPO_PACKAGIST 环境变量，是最简单、最可靠的方式——不需要改全局配置、不依赖宿主机缓存、也不用碰 auth.json。
为什么必须用环境变量而不是 config -g？
构建阶段的容器是干净的临时环境，composer config -g 写入的配置默认落在 /root/.composer/config.json，但这个路径在构建中既不持久也不被后续层复用；而环境变量在当前 RUN 中立即生效，且不污染文件系统。
-
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/是当前唯一稳定可用的中文镜像地址（https://packagist.phpcomposer.com已于 2026 年停用） - 别用
export单独设变量再执行composer install，shell 会话隔离导致变量不传递；必须写在同一行或用ENV+RUN组合 - Alpine 镜像必须先装证书：
RUN apk add --no-cache ca-certificates，否则即使换镜像也会报SSL certificate problem
Dockerfile 中怎么写才真正生效？
关键不是“设了没”，而是“在哪设、对哪生效”。下面这段是能跑通的最小可行写法：
RUN apk add --no-cache ca-certificates \
&& curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \
&& COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install --no-dev --optimize-autoloader
- 所有命令串在同一个
RUN里，避免分层后变量丢失 - 不要写成两行：
ENV COMPOSER_REPO_PACKAGIST=...+RUN composer install，Docker 的ENV在下一层才生效，当前RUN看不见 - 如果项目用了私有包，还需额外加
COMPOSER_AUTH，但值必须是 JSON 字符串格式，比如{"http-basic":{"your.repo.com":{"username":"x","password":"y"}}
为什么有时设了还卡在 “Resolving dependencies”？
这不是镜像源没生效，而是构建时根本没读到 composer.lock —— 它可能被 COPY 顺序搞错了。
-
COPY composer.json composer.lock ./必须放在composer install之前，且不能夹在其他COPY中间 - 如果只
COPY . .，Docker 缓存会失效，每次改任意代码都重跑composer install - 确认
composer.lock文件存在且格式正确：运行composer validate可提前发现语法错误 - 某些老版本 Composer（如 2.2.x）对 PHP 8.3+ 的 TLS 1.3 支持不稳定，建议固定用
composer:2.7.0或更高
最容易被忽略的一点：环境变量只对当前 RUN 生效，多阶段构建里每个 FROM 都要重新设；别以为第一阶段设了，第二阶段就能自动继承。
