Composer本身不支持主备镜像自动切换，所谓“高可用”必须靠外部控制流实现；repositories数组仅用于元数据合并与顺序匹配，遇超时或5xx错误直接报错退出，不触发fallback，仅404时才尝试下一源。
Composer 本身不支持主备镜像自动切换，所谓“高可用”必须靠外部控制流实现——要么用插件接管下载逻辑，要么用脚本探测 + 切换 + 清缓存。硬塞多个 repositories 进 composer.json 不会 fallback，只会让元数据混乱、安装变慢甚至失败。
为什么 repositories 数组不是主备 fallback 机制
Composer 按数组顺序请求每个源的 packages.json，合并成一张索引表；安装时只从第一个声明了该包完整版本信息的源拉 ZIP，其余源完全不参与下载。超时、502、DNS 失败等网络错误直接中断，不会尝试下一个源。
- 常见错误现象：
composer install卡在私有源超时，不自动切到阿里云镜像 - 把
https://mirrors.aliyun.com/composer/和https://packagist.org同时写进repositories，结果官方包仍走慢速源（因元数据合并顺序导致 dist URL 被覆盖） - 私有源临时不可达，
composer update直接报错退出，而非降级使用packagist.org
如何用 composer-plugin-mirror 实现真·自动 fallback
这是目前最轻量、无需改源码、兼容 Composer 2/3 的方案。它会在下载失败时，按顺序尝试配置里的镜像地址，直到成功或全部失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 安装插件：
composer global require yunwuxin/composer-plugin-mirror - 配置镜像列表（注意顺序：优先级从高到低）：
composer config -g repositories.packagist.type composer composer config -g repositories.packagist.url https://mirrors.aliyun.com/composer/ composer config -g repositories.packagist.packages '["*"]' composer config -g repositories.mirror1.type composer composer config -g repositories.mirror1.url https://mirrors.tencent.com/composer/ composer config -g repositories.mirror1.packages '["*"]'
- 插件按
repositories键名字母序排序，所以用mirror1、mirror2确保可控 - 每个镜像都必须声明
packages，填["*"]表示承接全部包，否则只代理指定包名
项目级双源配置：阿里云 + 官方兜底（仅限元数据）
如果不想引入插件，可手动编辑 composer.json，但必须严格遵循结构——否则官方源仍会被偷偷访问，或 ZIP 包不走镜像。
- 必须显式关闭默认源：
"packagist.org": false放在根节点，不能塞进repositories里 -
repositories数组中所有源类型必须为"type": "composer" - 顺序即优先级：国内镜像放最前，官方源放最后，且加
"packagist": true（不是"packagist.org"）{ "repositories": [ {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}, {"type":"composer","url":"https://packagist.org/","packagist":true} ], "packagist.org": false } - 注意：
"packagist": true只用于回退查元数据（packages.json），ZIP 包仍从第一个镜像下载——前提是那个镜像同步及时
CI/CD 中容灾失效的三个关键盲点
脚本写了探测、切换、清缓存，但在 CI 中仍失败，往往卡在这三点：
-
composer clear-cache必须执行，否则旧 DNS 或连接池残留会让请求继续发往已失效镜像 - Docker 构建中 vendor 目录复用，或 GitHub Actions 缓存未按镜像分片，导致不同源的依赖混用
- 项目级
composer.json中已定义repositories，会完全屏蔽全局配置（~/.composer/config.json），脚本改config -g没用
真正复杂的点在于：元数据（packages.json）和包文件（ZIP）是两个独立请求路径，镜像站若元数据同步延迟，就会出现“浏览器能打开 p2/xxx.json，但 composer require 报找不到包”的情况——这和你配了多少个源无关，得靠 "packagist": true 或插件兜底。
