Composer本身不支持热备和自动漂移，因其无fallback、health check或retry机制，仅认一个生效源；所谓主备切换必须由外部脚本实现探测、动态配置与清缓存。
为什么 Composer 本身不支持热备和自动漂移
Composer 没有 fallback、health check 或 retry-on-fail 机制——它只认一个生效源，死磕到底，超时才报错。所谓“热备”“自动漂移”全是外部逻辑，不是 Composer 自身能力。官方明确拒绝在核心中加入多源 fallback（GitHub issue #8729），这不是 bug，是设计决定。
如何让镜像切换真正生效：三个硬性条件缺一不可
执行 composer config -g repo.packagist 后没效果？大概率栽在这三点上：
-
repo.packagist键名必须是单数、小写、无 s；写成repos.packagist或repositories.packagist.org就静默失败 - 中间的
composer类型参数不能省：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/才对；漏掉composer就 fallback 到官方源 - URL 必须以
https://开头且末尾带/；写成https://mirrors.aliyun.com/composer会拼成/composerpackages.json，直接 404
项目级配置为何常被忽略：repositories 数组会屏蔽全局设置
只要项目根目录的 composer.json 里有 "repositories" 字段（哪怕空数组 [] 或空对象 {}），全局 repo.packagist 配置就彻底失效。这不是冲突，是 Composer 的加载优先级规则：项目级 > 全局配置。
常见错误现象：composer config -g repo.packagist 显示已设阿里云，但 composer update -vvv 日志里仍出现 Downloading https://repo.packagist.org/...。
验证是否真正在用目标镜像，必须三处核对：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g repo.packagist输出是否为完整 JSON 对象 -
composer diagnose中 “Repo:” 行域名是否匹配 -
composer show -p | head -3第一行是否为你设的镜像地址
真·故障漂移：用 shell 脚本实现探测 + 动态写入 + 清缓存
唯一可靠路径是外部脚本驱动三步操作：探测镜像根路径是否可访问 → 切换当前生效源 → 清缓存避免旧元数据干扰。
示例探活命令（检测阿里云）：
curl -s -f -m 10 https://mirrors.aliyun.com/composer/packages.json > /dev/null
失败则切腾讯云：
curl -s -f -m 10 https://mirrors.cloud.tencent.com/composer/packages.json > /dev/null
探测成功后执行：
composer config -g repo.packagist composer $URL-
composer clear-cache（漏这步，缓存里的 packages.json 还指向旧源） - CI 中建议封装为预处理任务，避免每次
composer install都卡在慢源上
注意 Windows 下 Git Bash 可能读取 %APPDATA%\Composer\config.json 而非 ~/.composer/config.json，脚本里要适配路径。
