Composer不支持多个镜像源自动fallback，执行composer config -g repo.packagist多次会覆盖而非叠加，主备切换需靠外部脚本探测可用性、动态切换并清缓存，非配置可实现。
composer config -g 只能设一个镜像，多源不是配置出来的
Composer 本身不支持多个镜像源自动 fallback。执行 composer config -g repo.packagist 多次，后一次会直接覆盖前一次——这不是 bug，是设计如此（官方 GitHub issue #8729 明确拒绝该特性）。所谓“主备镜像”必须靠外部工具控制流程，不能靠改配置实现。
常见错误包括：
- 用空格拼两个 URL：
composer config -g repo.packagist composer https://a.com https://b.com→ 命令只认第一个，第二个被忽略 - 以为写进
composer.json的repositories数组能自动重试 → 实际只在元数据合并阶段查一遍，下载时只从第一个声明了该包的源拉取，遇到 502/超时直接报错退出 - 没显式禁用默认源：
"packagist.org": false没加在composer.json根节点 → Composer 仍会偷偷连官方源，导致诊断警告或意外请求
用 Bash 脚本做真容灾：探测 + 切换 + 清缓存
可靠方案是写个轻量脚本，把三步串起来：检测镜像根路径可用性 → 切换当前生效源 → 清缓存避免旧元数据干扰。以下为最小可行示例（保存为 switch-composer-mirror.sh）：
#!/bin/bash
MIRRORS=(
"https://mirrors.aliyun.com/composer/"
"https://mirrors.cloud.tencent.com/composer/"
"https://mirrors.huaweicloud.com/repository/php/"
)
for url in "${MIRRORS[@]}"; do
if curl -s -o /dev/null -f -m 5 "$url"packages.json; then
echo "✅ Using $url"
composer config -g repo.packagist composer "$url"
composer clear-cache
exit 0
fi
done
echo "❌ All mirrors failed"
exit 1
要点说明：
-
curl -f -m 5确保超时即失败，不卡住；packages.json是 Composer 元数据入口，比测首页更准 - 每次切换后必须执行
composer clear-cache，否则旧缓存可能继续指向已失效源 - 脚本不修改
composer.json，避免污染项目，且对 CI 和多用户环境（如宝塔）友好
项目级多源要手动控制顺序，不能依赖自动 fallback
如果你非要在项目里声明多个源（比如同时用阿里云镜像 + 私有包源），关键不是“备用”，而是“优先级排序”。Composer 按 repositories 数组顺序扫描元数据，第一个返回 200 的源胜出。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确写法示例（写入 composer.json）：
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
},
{
"type": "composer",
"url": "https://my-private-repo.example.com"
},
{
"packagist": false
}
]
注意：
- 必须把公共镜像放第一位，私有源放第二位，否则私有包可能被公共镜像“抢答”返回 404
-
{"packagist": false}必须作为最后一项，显式关闭默认源；写成{"url": "https://packagist.org/"}会导致 ZIP 下载也走海外 - 所有自定义源都必须带
"type": "composer"，漏掉会报Invalid repository type
验证是否真生效，别信“命令没报错”
执行完切换命令，很多人就以为搞定了。但 Composer 会缓存、会 fallback、会受项目级配置压制——必须实测验证：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或含packagist.org都算失败 - 执行
composer install -vvv 2>&1 | grep -i "mirrors\|packages.json"，日志里应出现你设的镜像域名，且无packagist.org - 删掉
vendor/和composer.lock后重试，否则 Composer 可能沿用 lock 文件里记录的老地址
最容易被忽略的是：换源后首次 composer update 卡在 Resolving dependencies，那和镜像完全无关——那是本地 PHP 解析依赖树慢，得调 memory_limit 或检查 composer.json 写法。
