Composer不支持镜像源自动倒退或容灾回滚，仅当首个源对某包返回404时才查下一源；超时、5xx等错误直接报错退出，真容灾需外部脚本完成探测、切换、清缓存三步原子操作。
Composer 本身不支持“镜像源自动倒退”或“容灾回滚”——它连基础 fallback 都没有，更别说按版本、按时间、按失败类型做智能降级。所谓自动化，必须靠外部脚本驱动，且要同时解决三个独立问题：源可用性探测、版本约束重写、缓存与 lock 文件协同。
为什么 composer install 不会自动换镜像源
因为 Composer 的 repositories 数组不是故障转移列表，而是元数据声明顺序表。它只做两件事：
- 依次请求每个源的
packages.json，合并所有包名+版本信息，生成本地索引 - 对每个待安装包，从数组第一个源开始查：只要该源返回了这个包（哪怕只有 v1.0.0），就锁定它，并用它的
dist.url下载 ZIP - 仅当第一个源对某包明确返回 HTTP 404（注意：不是超时、不是 502、不是 DNS 失败），才查第二个源是否声明了该包
这意味着：curl -I https://mirrors.aliyun.com/composer/packages.json 返回非 200 就直接报错退出，根本不会走到第二个源；你把腾讯云镜像写在第二位，它只会在阿里云对某个包说“没这个版本”时才启用，而不是“阿里云挂了就切”。
如何用 shell 脚本实现镜像源探测 + 切换 + 清缓存原子操作
真容灾不是配个数组，而是三步必须同时执行的原子动作：探测 → 切换 → 清对应 provider 缓存。缺一不可。
推荐轻量 shell 实现（不依赖 PHP、不污染全局配置）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json探活，只认200；失败则 fallback 到https://packagist.org - 用
composer config repositories.packagist url https://xxx写入项目级配置（不碰~/.composer/config.json） - 执行
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（或对应 URL 的缓存目录），避免旧元数据干扰 - 加
--no-plugins和COMPOSER_NO_INTERACTION=1防插件篡改或交互中断
注意：composer clear-cache 没用——它只清 vendor 包缓存，不删 provider 元数据缓存；必须手动 rm -rf 对应目录。
版本倒退时镜像源怎么不拖后腿
降级失败常被误判为镜像问题，实际是镜像同步延迟 + 版本约束冲突双重作用。例如你执行 composer require monolog/monolog:2.9.2 --with-all-dependencies 却失败，可能因为：
- 阿里云镜像还没同步
monolog/monolog的 v2.9.2 元数据（providers-*.json里没这条记录），导致 Composer 根本查不到这个版本 - 项目
composer.json里写了"repositories": [...]，但其中某个私有源也声明了monolog/monolog（哪怕只提供 v1.x），Composer 就会锁定那个源，而它显然不提供 v2.9.2 -
composer.lock里已存 v2.10.0 的哈希，但你没删 lock 文件就跑require，Composer 可能跳过重算
实操建议：
- 先确认目标版本是否存在：访问
https://mirrors.aliyun.com/composer/p2/monolog/monolog.json，看返回是否含"2.9.2" - 临时删掉项目
composer.json中所有repositories字段，让 Composer 回退到官方源解析元数据（再加-d repo.packagist=composer强制） - 执行前确保
composer.lock是干净的（或备份后删掉），否则require可能被 lock 锁死
最关键的遗漏点：packagist.org 的显式兜底必须写对
很多人在 repositories 数组末尾加 {"type":"composer","url":"https://packagist.org/"}，结果发现还是找不到包——因为这行只是告诉 Composer “去官方源下 ZIP”，但元数据仍从第一个镜像拉。正确写法是：
{
"repositories": [
{"type":"composer","url":"https://my-private-repo.example.com"},
{"type":"composer","url":"https://mirrors.aliyun.com/composer/"},
{"packagist": true}
],
"packagist.org": false
}
注意两点："packagist": true 是特殊关键字，不是普通 URL；"packagist.org": false 必须作为顶层字段，不能塞进 repositories 里。否则 Composer 会忽略它，偷偷访问官方源，或者干脆报错。
