根本原因是容器内 Composer 默认直连海外 packagist.org，DNS/TLS/下载均经容器网络栈且叠加 Docker DNS 延迟，加每次构建 vendor 缓存失效；需在 Dockerfile 中显式配置国内镜像源、分层固化依赖、禁用 Xdebug/opcache。
为什么容器内 Composer install 特别慢
根本原因不是网络差，而是默认镜像没做任何加速配置：PHP 镜像里 composer 直连 packagist.org（海外源），DNS 解析 + TLS 握手 + 下载全在容器网络栈里走一遍，还叠加了 Docker 默认的 DNS 转发延迟。更关键的是，每次构建都从零下载 vendor，缓存完全失效。
Dockerfile 里必须设置国内镜像源
不能只靠宿主机配置，容器内 composer 启动时读的是自身环境，必须在构建阶段就写死镜像源。推荐用阿里云或腾讯云源，比华为云源更稳定。
- 全局设置（推荐）：在
RUN指令中执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 临时覆盖（适合多源切换）：把
composer install --repository=https://mirrors.aliyun.com/composer/写进命令，但注意这会忽略composer.json里的repositories配置 - 避免用
composer config --global写入用户目录，因为基础镜像里可能没创建/root/.composer或权限不对，导致静默失败
利用多阶段构建跳过 vendor 缓存重建
很多 Dockerfile 把 composer install 放在最后，导致只要改一行代码，前面所有依赖下载全白跑。正确做法是分层固化依赖：
- 第一阶段 COPY
composer.json和composer.lock，立刻运行composer install --no-dev --no-scripts --optimize-autoloader - 第二阶段用
COPY --from=builder /app/vendor /app/vendor复用编译好的 vendor，不重装 - 务必加
--no-dev，否则 dev 依赖（如 phpunit）会混进生产镜像，增大体积且可能引入安全风险
禁用 Xdebug 和其他扩展干扰安装速度
有些 PHP 基础镜像默认启用了 Xdebug，它会让 composer 执行慢 3–5 倍，尤其在 autoload 生成阶段。不是所有镜像都自动关，得手动干预：
- 检查是否启用：
RUN php -m | grep xdebug - 禁用方式（根据镜像类型选）：
RUN docker-php-ext-disable xdebug（官方 PHP 镜像）或RUN rm /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini - 同理，
opcache在安装阶段也建议关掉，避免字节码缓存干扰 autoloader 生成逻辑
真正卡住的点往往不在“换源”本身，而在于构建流程没隔离好依赖层、扩展没关干净、或者误以为宿主机的 ~/.composer/config.json 会透传进容器——它不会。
