composer install卡在“loading composer repositories”根本不是网络慢，而是镜像源配置错误：键名必须为repo.packagist、type值必须显式设为composer、url须https且末尾带/，三者缺一即静默回退官方源。
composer install报错根本不是网络慢，是镜像源没配对
容器里composer install卡在“Loading composer repositories”或直接403，90%不是DNS或带宽问题，而是repo.packagist配置写错了。它必须同时满足三个条件：键名是repo.packagist（不能是repos.packagist或repositories.packagist），type值显式设为composer，URL必须以https://开头且末尾带/。
-
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ -
RUN composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/❌（键名错，静默失效） -
RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌（漏type，Composer 2.x直接忽略） -
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer❌（缺末尾/，拼出/composerpackages.json导致404）
验证是否生效：RUN composer config -g repo.packagist输出必须是完整JSON对象，比如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果为空、null或仍是https://packagist.org，说明没写进去。
Dockerfile里composer命令找不到？得自己装，别信apt
官方php:8.2-cli等镜像默认不含composer命令，RUN composer install直接报/bin/sh: 1: composer: not found。用apt install composer会装旧版、权限错乱，官方明确不推荐。
- 用官方安装脚本：
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 必须启用必要PHP扩展：
RUN docker-php-ext-install zip mbstring openssl（不是apt-get install php-zip） - Alpine镜像额外装证书：
RUN apk add --no-cache ca-certificates，否则报SSL certificate problem - 设缓存目录权限：
ENV COMPOSER_HOME=/tmp/composer+RUN mkdir -p $COMPOSER_HOME && chmod 777 $COMPOSER_HOME
vendor重装太慢？COPY顺序和缓存层决定成败
构建变慢不是因为composer install本身慢，而是Docker缓存没命中。只要composer.json或composer.lock一改，后续所有层全失效——尤其当你先COPY . /app再跑composer install时，改一行代码就重装整个vendor/。
- 必须按顺序
COPY：COPY composer.lock .→COPY composer.json .→RUN composer install --no-dev --optimize-autoloader - 千万别把
composer.lock放在composer.json后面复制，否则composer install退化成update，版本失控 - 多阶段构建中，builder阶段用
--no-dev --classmap-authoritative，运行镜像里不带vendor/bin/工具 - 私有包认证别硬编码，用BuildKit secret：
RUN --mount=type=secret,id=auth,dst=/tmp/auth.json composer install
启动时报ext-zip missing或autoload失败？别在运行时装依赖
把composer install写进ENTRYPOINT或CMD是反模式。每次Pod重启或容器启动都重拉包，网络失败率高、启动延迟大、PHP扩展缺失到运行时才暴露，根本没法回滚。
- 生产镜像必须固化
vendor/——构建阶段完成安装，运行镜像只含可执行文件和autoload优化后的映射 - 检查
autoload.php路径是否匹配WORKDIR，比如WORKDIR /app但autoload.php生成在/var/www/html/vendor/autoload.php，就会require失败 - 别用
--ignore-platform-reqs掩盖问题，它让mbstring或zip缺失变成静默跳过，运行时报错更难定位 - K8s里InitContainer跑
composer install同样危险，网络就绪顺序不可控，应彻底移除
最易被忽略的点：Alpine镜像缺CA证书、系统时间偏差超2分钟导致SSL校验失败、composer.lock未提交却指望构建复现——这些不会报明显错误，但会让composer install在不同环境表现不一致。
