Composer不支持主备自动切换或镜像翻转，repo.packagist是单值字段，设多个地址会报错；真要故障切换需靠外部脚本探测并设置环境变量。
Composer 没有“镜像翻转”或“对称模型”这类概念，它不支持主备自动切换、fallback 轮询、源间负载均衡或双向同步机制。所谓“翻转”“对称”都是误读，实际只能手动指定一个生效源。
为什么composer config -g repo.packagist设两个地址会报错
Composer 的 repositories.packagist.org（或兼容写法 repo.packagist）是单值字段，不是数组。你在全局配置里重复写两次 {"type": "composer", "url": "..."}，会触发 Invalid repository type 错误——因为它只认一个合法的 packagist 源，多一个就直接拒载。
- 试图在
config.json里手写两个同类型源，必然失败 - 项目级
composer.json中定义"repositories"数组时，若包含多个"packagist.org"映射，同样被拒绝 - Composer 2.2+ 已弃用
repo.packagist旧键名，但即使你用新键repositories.packagist.org，它仍是单值，无法塞多个 URL
composer diagnose 显示 “Repo is not configured properly” 怎么办
这不是错误，是提示：你启用了镜像源，但没显式关闭默认的 packagist.org 自动代理。Composer 5.0+ 默认开启该代理，和镜像共存时会警告。
- 安全做法是显式禁用官方源：
composer config -g repos.packagist false - 再单独加镜像：
composer config -g repos.aliyun composer https://mirrors.aliyun.com/composer/ - 注意此时
repos.aliyun是自定义名，不再走自动映射逻辑，也就不会触发警告 - 验证：
composer config -g repos应输出含"type": "composer"的完整对象
真要实现“故障切换”，只能靠外部脚本
Composer 自身不探测、不重试、不换源。它只做一件事：用当前生效的那个 URL 尽力下载（含 dist/source 切换、断点续传），但不会因超时或 404 主动切到另一个镜像。
- 典型方案是 shell 脚本 +
curl -I探活，成功则设COMPOSER_REPO_PACKAGIST环境变量，失败则 fallback 到备用地址 - CI 场景推荐预设多套配置文件，用
cp config-aliyun.json ~/.composer/config.json替换，比运行时判断更稳定 - 别依赖
composer clear-cache来“触发切换”——缓存清理只影响元数据本地副本，不改变源地址本身 - Windows 下 Git Bash 可能读
%APPDATA%\Composer\config.json，而非~/.composer/config.json，脚本里得先确认路径
最常被忽略的一点：项目根目录下的 composer.json 一旦声明了 "repositories" 字段（哪怕空数组），全局配置就彻底失效，且无任何提示。排查时第一件事永远是 grep -n repositories composer.json。
