Composer不支持多个镜像源自动fallback，因其repo.packagist.org为单值字段，后设URL直接覆盖前设；repositories数组仅用于静态元数据合并，下载时只从首个声明该包的源拉取，超时或5xx错误即报错退出，真容灾需外部脚本探测可用性、动态切换源并清缓存。
composer 不支持多个镜像源自动 fallback，所谓“主备切换”不是配置出来的，而是靠外部控制流实现的。你不能靠 composer config -g repo.packagist.org 写两次就得到两个可用源——后一次会直接覆盖前一次。
为什么 repo.packagist.org 只能设一个 URL
这个配置项是单值字段，底层只存一个字符串。执行：composer config -g repo.packagist.org https://mirrors.aliyun.com/composer/
再执行：composer config -g repo.packagist.org https://mirrors.tencent.com/composer/
后者会彻底抹掉前者。这不是 bug，是 Composer 的设计决定，GitHub issue #8729 中官方已明确拒绝加入多源 fallback。
常见错误：
- 用空格拼两个地址：
composer config -g repo.packagist.org https://a.com https://b.com→ 命令失败或仅第一个生效 - 以为加了全局配置，项目里就不需要处理 → 项目级
composer.json中定义了repositories，全局配置完全失效 - 改完没生效 → 忘了加
--global，或项目里已有repositories覆盖了全局设置
repositories 数组不是 fallback 机制
你在 composer.json 里写多个 {"type": "composer", "url": "..."} ，Composer 并不会在下载失败时重试下一个源。它只做两件事：
- 按数组顺序请求每个源的
packages.json，合并成一张索引表（元数据阶段） - 安装时，从第一个声明了该包完整版本信息的源拉 ZIP 包 —— 其余源不参与下载
关键限制：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 只有返回明确
404（包不存在）才查下一个；502、超时、DNS 失败会直接中断报错 - 必须显式写
"packagist.org": false在composer.json根节点，否则 Composer 仍会偷偷连官方源 - 兜底元数据需用
{"packagist": true}放数组末尾，不是{"url": "https://packagist.org/"}，否则 ZIP 也会走官方源 - 所有自定义源必须是
"type": "composer"，混用vcs或漏字段会导致Invalid repository type
真·容灾：用脚本探测 + 切换 + 清缓存
可靠方案只能靠外部脚本控制三步流程：探测镜像根路径是否可访问 → 切换当前生效源 → 清缓存避免旧元数据干扰。示例（Bash）：
#!/bin/bash
MIRROR_ALIYUN="https://mirrors.aliyun.com/composer/"
MIRROR_TENCENT="https://mirrors.cloud.tencent.com/composer/"
FALLBACK="https://repo.packagist.org/"
if curl -I -s -o /dev/null -w "%{http_code}" "$MIRROR_ALIYUN"packages.json | grep -q "200"; then
composer config -g repo.packagist.org "$MIRROR_ALIYUN"
elif curl -I -s -o /dev/null -w "%{http_code}" "$MIRROR_TENCENT"packages.json | grep -q "200"; then
composer config -g repo.packagist.org "$MIRROR_TENCENT"
else
composer config -g repo.packagist.org "$FALLBACK"
fi
composer clear-cache
注意点：
- 探测必须检查
packages.json路径，不能只 ping 域名或根路径 - 切换后务必执行
composer clear-cache，否则可能因缓存残留导致 404 - CI/CD 中建议把脚本封装为前置步骤，不要依赖人工干预
- 别用
sed或jq直接改~/.composer/config.json—— Composer 加载时只认第一个repo.packagist.org字段
项目级双源配置的最小安全写法
若只需阿里云 + 官方兜底（非自动 fallback），且不想动全局配置，直接在项目 composer.json 里写：
{
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"packagist": true}
],
"packagist.org": false
}
说明：
-
{"packagist": true}是元数据兜底，只用于查packages.json，ZIP 仍走阿里云 -
"packagist.org": false必须在根节点，不能塞进repositories里 - 顺序即优先级：阿里云在前，新包先查它；若它返回 404（比如刚发布的包还没同步），才触发
{"packagist": true} - 这种写法不解决网络故障问题，只解决镜像元数据滞后问题
composer require 成功了，不代表 ZIP 一定从镜像下载——得看日志里 Downloading 后面的 URL。而一旦镜像服务端返回非 200 状态码（哪怕只是临时 503），整个流程就会卡死，没有任何内部重试逻辑。 
