composer镜像配置失效主因是composer config -g repo.packagist命令未严格满足三条件：键名必须为单数repo.packagist、第三参数composer（type值）不可省略、url须https且末尾带/，任一缺失即静默回退至packagist.org。
根本不是网络差，而是你根本没走中文镜像——composer config -g repo.packagist 写错一个字母、少一个斜杠、漏掉 composer 类型值，都会静默 fallback 到 packagist.org，然后卡在 provider-2022-07.json 或下载一半报 Content-Length mismatch。
为什么换镜像后还是直连 packagist.org？
Composer 2.x 只认 repo.packagist 这个固定键名（单数、全小写、无 s），写成 repos.packagist 或 packagist.org 都不会报错，但配置无效。验证方法只有两个：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，且 URL 末尾带斜杠：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 执行
composer install -vvv | grep -i mirrors，日志里必须出现镜像域名；没输出=还在直连海外 - 项目根目录下有
repositories字段？它会覆盖全局配置——删掉整个字段再试，别留空数组或注释
中断后重试为啥越试越错？
Composer 没有断点续传，所谓“重试”只是跳过已解压成功的包。但中断常导致三类不可逆污染：
-
Failed to extract vendor/package-name: unable to open archive→ 缓存里的 ZIP 已损坏，rm -rf vendor不够，必须composer clear-cache -
Invalid argument supplied for foreach()→vendor/composer/installed.json被截断，删vendor后会重建，但缓存不清理，下次仍读坏包 - 进度条卡在 42% 超过 2 分钟，且
-vvv显示刚下载完就校验失败 → 立刻停手，执行三步：删vendor、composer clear-cache、composer install --no-plugins --no-scripts --prefer-dist
怎么让安装真正稳住？
不是调超时、不是装插件，而是控制数据来源和解压路径：
- 强制走 dist 包：
--prefer-dist避开 git clone，体积小、校验快、失败率低 - 禁用插件：
--no-plugins绕过旧版hirak/prestissimo等引发的并发崩溃 - 延长超时：
composer config -g process-timeout 1800（单位秒），防大包被默认 300 秒中断 - 并行下载（Composer 2.2+）：
composer config -g parallel-downloads 6，Docker 构建中别设太高，临时文件竞争会导致随机失败
最常被忽略的是 composer.lock 里记录的 dist.url 还指向原始源——哪怕镜像已生效，composer install 仍会先尝试旧地址。清理后第一次安装必须跑完整流程，别加 --dry-run 或跳过校验。
