Composer不支持全局多镜像，composer config -g repo.packagist仅能设一个URL，后写入的会覆盖前一个；可靠高可用需在composer.json中显式配置repositories数组并设"packagist.org": false。
Composer 本身不支持“配置多个镜像”这种操作——你用 composer config --global repo.packagist 写两次，第二次必然覆盖第一次；往 repositories 数组里硬塞两个国内镜像，反而导致元数据混乱、安装变慢甚至失败。
为什么 composer config --global repo.packagist 只能设一个地址
这个配置项对应 JSON 中的单值字段 "repo.packagist"，不是数组。执行：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ composer config -g repo.packagist https://mirrors.tencent.com/composer/
第二条会直接抹掉第一条。这不是 bug，是设计如此。所有“多镜像脚本 sed 替换 config.json”的做法都无效，因为 Composer 加载时只读第一个 repo.packagist 字段。
- 真正生效的只有最终写入的那个 URL
- 想靠它实现 fallback？不可能——它连重试逻辑都没有
- 全局配置还会被项目级
composer.json中的repositories完全覆盖
想让阿里云 + 官方源协同工作，必须改 composer.json
唯一可靠的方式是显式声明多个源，并关闭默认行为。正确结构如下（放在项目根目录 composer.json 中）：
{
"repositories": [
{ "type": "composer", "url": "https://mirrors.aliyun.com/composer/" },
{ "type": "composer", "url": "https://packagist.org/" }
],
"packagist.org": false
}
注意三点：
-
"packagist.org": false必须写在根节点，不能塞进repositories里，否则无效 - 两个源都必须是
"type": "composer"，别写成artifact或package - 顺序即优先级：阿里云在前，官方源仅在阿里云返回
404（包确实不存在）时才触发；超时、502、DNS 失败都不会切——它不是“失败即切”，而是“等满才切”
为什么配了双源，composer install 还卡 30 秒
因为 Composer 默认对每个源单独等待 30 秒超时，才尝试下一个。网络卡顿、TLS 握手慢、IPv6 fallback 延迟都会拖住这个计时器。
- 临时验证是否走镜像：加
-vvv参数，看日志里实际请求的域名 - 避免卡死：全局延长超时
composer config -g http.timeout 600 - 更治本：加环境变量
COMPOSER_IPV4=1强制走 IPv4，绕过 IPv6 延迟 - 别信“自动 fallback”——镜像服务端是否兜底，和你本地配置无关；腾讯云镜像带服务端 fallback，阿里云不带，选哪个镜像比怎么配更重要
真正影响稳定性的，往往不是镜像数量，而是这几个细节
堆 URL 没用，但以下三件事不做，再好的镜像也白搭：
- 没关掉默认源：
"packagist.org": false缺失会导致 Composer 偷偷访问官方源，破坏你设的顺序 - 没强制 IPv4：
COMPOSER_IPV4=1不设，某些网络环境下会因 IPv6 超时白白耗掉 30 秒 - 没延长 HTTP 超时：
http.timeout保持默认 30 秒，遇到波动就卡死，设成 600 更稳妥
这些细节比“配几个镜像”管用十倍。镜像同步延迟、服务端 fallback 能力、本地网络路由策略，才是真正决定 Composer 是否稳定的底层因素。
