composer不支持多镜像自动切换，因repo.packagist为单值字符串字段，后设覆盖前设；项目级repositories仅404时才fallback，超时或502即失败；可靠方案是外部探活脚本或选用自带服务端兜底的镜像站。
Composer 本身不支持“多个国内镜像自动切换”——composer config -g repo.packagist 是单值字段，后设必覆盖前设；项目级 repositories 数组里塞多个 Packagist 镜像，反而导致元数据冲突、安装失败或变慢。
为什么 composer config -g repo.packagist 只能写一个地址
这个配置项在 ~/.composer/config.json 中对应的是一个字符串字段："repo.packagist": "https://..."。它不是数组，也不是对象，更没有重试逻辑。执行：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ composer config -g repo.packagist https://mirrors.tencent.com/composer/
第二条命令会直接抹掉第一条写入的 URL。这不是 bug，是 Composer 的明确设计。
- 所有试图用
sed或jq往 config.json 里硬塞多个 URL 的做法都无效——Composer 加载时只取第一个repo.packagist字段值 - 全局配置会被项目级
composer.json中的repositories完全屏蔽，二者不合并 - 超时、502、DNS 解析失败等网络错误，不会触发任何 fallback，命令直接报错退出
项目级 repositories 数组不是“备用”，是“顺序匹配 + 404 才往下走”
你可以在项目 composer.json 里写多个源，但行为非常严格：
- 只有当前一个源返回 HTTP 404（包确实不存在）时，Composer 才查下一个；超时或 502 就中断，不会继续试
-
"packagist.org": false必须写在根节点，不能塞进repositories里，否则无效 - 两个源都得是
"type": "composer"，别误写成artifact或package - 顺序 = 优先级：阿里云在前，官方源仅作兜底元数据（
packages.json），ZIP 包仍走第一个镜像
正确结构示例：
{
"repositories": [
{"type":"composer","url":"https://mirrors.aliyun.com/composer/"},
{"type":"composer","url":"https://packagist.org/"}
],
"packagist.org": false
}
真正可用的备用方案：shell 函数 + 探活脚本
想实现“检测镜像可用性 → 自动切源 → 重试”，只能靠外部控制流。推荐两种轻量方式：
- 在
~/.zshrc或~/.bashrc里加 alias：
alias composer-aliyun='composer config -g repo.packagist https://mirrors.aliyun.com/composer/' alias composer-tencent='composer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/' alias composer-laravel-china='composer config -g repo.packagist https://packagist.laravel-china.org/'
- 或写个探活脚本（
~/bin/composer-safe-install）：
#!/bin/bash
MIRRORS=("https://mirrors.aliyun.com/composer/" "https://mirrors.cloud.tencent.com/composer/" "https://packagist.laravel-china.org/")
for url in "${MIRRORS[@]}"; do
if curl -sI "$url"packages.json | head -1 | grep -q "200"; then
composer config -g repo.packagist "$url"
composer install "$@" && exit 0
fi
done
echo "All mirrors unavailable"
exit 1
注意：每次切源后，Composer 会清本地缓存，首次 update 略慢几秒；脚本需 chmod +x 后使用。
最容易被忽略的点：镜像服务端能力比本地配置更重要
与其花时间折腾本地多源 fallback，不如选一个自带容灾能力的镜像站——比如腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）已内置服务端自动回退到官方源的逻辑。你本地只配这一个地址，就能获得事实上的“备用”效果。而阿里云、Laravel China 等镜像若服务端没做兜底，本地再怎么切源也无济于事。这点常被忽略，但恰恰是实际体验差异最大的地方。
