Composer不支持自动故障切换，因其repositories仅为静态元数据合并，下载时只从首个提供完整版本信息的源拉取，失败即报错；真容灾需外部脚本探测可用性、动态切换源并清缓存。
Composer 镜像源挂了不会自动切备用源，这是设计使然，不是 bug —— 它压根不支持运行时 fallback。 你看到的“多个 repositories 写进 composer.json 就能容灾”，其实是常见误解。真要防止单点失效，得靠外部脚本探测 + 动态切换 + 清缓存，缺一不可。
为什么 repositories 数组不能当备用源用
Composer 的 repositories 是静态元数据合并逻辑，不是请求代理层。它按数组顺序读取各源的 packages.json，合并成一张索引表；下载 dist 包时，只从第一个提供该包完整版本信息的源拉取，哪怕那个源超时、502 或 DNS 失败，也不会尝试下一个。
- 常见错误现象：
composer install卡在Downloading https://my-private-repo.example.com/xxx.zip，不往下走阿里云镜像 - 把
https://mirrors.aliyun.com/composer/和https://packagist.org同时写进repositories，结果官方包仍走慢速私有源（因元数据合并顺序导致 dist URL 被覆盖） - 私有源临时 503，
composer update直接报错退出，而非降级使用packagist.org
如何用脚本实现真·容灾切换
核心是三步：探测可用性 → 切换生效源 → 清缓存避免旧元数据干扰。推荐用 shell 脚本驱动，CI/CD 或本地开发都适用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 - 若失败，改用
https://packagist.org或腾讯云镜像（它默认开启回源，对新包更友好） - 通过
composer config repositories.packagist.org '{"type": "composer", "url": "https://xxx/"}'动态写入项目级配置（不加-g），确保不覆盖私有源结构 - 必须执行
composer clear-cache，否则本地缓存的packages.json仍指向已失效源
项目级配置比全局更可靠，但要注意写法
全局配置（composer config -g）容易被项目 composer.json 中任意 repositories 字段完全屏蔽——哪怕只是空数组或只写了 "packagist.org": false。项目级配置可 Git 提交，行为一致，更适合协作。
- 正确写法：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g，自动合并进composer.json的repositories对象） - 如果原
composer.json里repositories是数组（如含私有源），命令会失败；需先手动改为对象"repositories": {}再运行 - 显式兜底
packagist.org必须放在repositories数组末尾，并单独加"packagist.org": true字段（不是嵌套在对象里） - URL 必须以
/结尾，否则Invalid repository type或 404 ——https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
临时验证镜像是否真可用，别动配置
调试或 CI 流水线中想快速确认某个镜像能否拉包，又不想污染环境？用 --repository 参数强制指定，配合 -vvv 看真实请求地址最直接。
- 单次指定：
composer create-project laravel/laravel myapp --repository https://mirrors.ustc.edu.cn/composer/ -vvv - 只对当前命令生效，不写入任何配置，适合排查网络或镜像同步延迟问题
-
-vvv日志里出现Downloading https://mirrors.ustc.edu.cn/composer/...才算真正走镜像，光看composer diagnose不够 - 注意：该参数要求 Composer ≥2.2，1.x 不支持
真正麻烦的不是换源命令本身，而是元数据缓存、配置优先级和镜像同步延迟这三者交织。一次 clear-cache 不够，得确认 composer config 输出、composer diagnose 显示的 Repo 域名、以及 -vvv 日志里的实际请求 URL 三者一致，才算稳了。
