Composer不支持自动fallback，备用镜像需脚本探测+切换+清缓存；repositories为顺序匹配非备份，失败仅对404重试；repo.packagist全局配置仅容单值且格式严格，缺一不可。
Composer 不支持“备份源”或“自动 fallback”，所谓备用镜像必须靠外部控制流实现——要么手动切换，要么用脚本探测 + 切换 + 清缓存。你写进 repositories 的多个地址不是备份，而是按顺序匹配的独立源；repo.packagist 更是单值字段，后设必覆盖前设。
composer config -g repo.packagist 只能设一个 URL，写错就静默失效
这条命令必须严格满足三要素，缺一不可：
-
repo.packagist（不是repos.packagist，多一个s就完全无效） -
composer（这是type值，不是可选参数，省略则 fallback 到默认源） - URL 必须是 HTTPS 且末尾带
/（例如https://mirrors.aliyun.com/composer/，少斜杠会拼成/composerpackages.json导致 404）
验证是否生效：运行 composer config -g repo.packagist，正确输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或报错，说明没写对。
repositories 数组不是“备份”，是“顺序匹配”，且失败不重试
在 composer.json 里写多个 repositories，行为非常严格：
- 只对第一个返回 HTTP 404 的源才继续往下试；超时、502、DNS 失败等网络错误会直接中断，不会 fallback
- 一旦声明了
repositories，全局配置（~/.composer/config.json）就完全失效，不是合并 - 若想让
packagist.org当兜底，必须显式加到最后，并配"packagist": true，否则它被默认禁用
错误示例：{"type":"composer","url":"https://packagist.org"} 缺少 "packagist": true 字段，Composer 不认它为官方源兜底。
真·容灾只能靠脚本：curl 探活 + 动态切换 + 清缓存
可靠的做法是用 shell 脚本在每次 composer install 前做三件事：
- 用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json检查镜像根路径是否返回200 - 失败则切到备用地址，执行
composer config repositories.packagist composer https://packagist.org/（项目级）或composer config -g repo.packagist composer https://packagist.org/（全局） - 紧接着执行
composer clear-cache，避免旧元数据干扰
注意：composer config 写入的是 composer.json 的 repositories 字段，会覆盖原有结构，所以脚本需保留私有源位置，仅替换镜像 URL；另外，CI 环境中若用 sudo composer config -g，可能写进 root 用户配置，但构建用的是普通用户，根本读不到。
最易被忽略的一点：镜像只加速下载，不解决 Resolving dependencies 卡顿。如果你换源后依然卡在这一步，问题不在镜像，而在 composer.json 的约束太宽、PHP 版本范围过大，或 require-dev 里塞了太多未锁定的工具链。
