Composer根本不支持多级镜像或自动fallback，唯一可靠方案是在composer.json中严格配置repositories数组并设"packagist.org": false，顺序即优先级，且需添加{"packagist": true}兜底元数据。
Composer根本不支持“多级镜像”这个概念
你搜到的“多级镜像”“主备切换”“自动 fallback”等说法，基本都源于对 Composer 行为的误读。Composer 的 repo.packagist 是单值字段，不是数组——composer config -g repo.packagist 执行两次，第二次必然覆盖第一次；往 repositories 数组里硬塞两个 type: "composer" 的源，不仅不会自动切换，反而会触发 Invalid repository type 报错或元数据混乱。
所谓“主备”，本质是服务端能力（比如腾讯镜像站自带 503 自动回源），不是 Composer 客户端能控制的逻辑。它连超时重试都没有，更别说智能路由了。
- 所有“用 sed/jq 往 config.json 里塞多个 URL”的脚本都无效：Composer 加载时只读第一个
repo.packagist字段 -
repositories是给私有源、Satis、Git 包用的，不是给 packagist 镜像叠 buff 的 - 如果你在项目
composer.json里写了"repositories": [...]，全局配置--global就直接失效
真正能落地的“双源兜底”只有一种写法
必须改项目级 composer.json，且结构严格限定。下面这段是截至 2026 年仍被 Composer 2.9+ 稳定支持的唯一可靠形式：
{
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"type": "composer", "url": "https://packagist.org/"}
],
"packagist.org": false
}
注意三点：
-
"packagist.org": false必须写在根节点，不能包进repositories里，否则无效 - 顺序即优先级：阿里云在前，官方源仅在阿里云返回 404（包确实不存在） 时才查，超时、502、DNS 失败都不会切
- 必须补上
"packagist": true条目（不是"packagist.org"），否则新发布的包可能因镜像元数据延迟而报Could not find package
补全后的完整结构示例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"type": "composer", "url": "https://packagist.org/"},
{"packagist": true}
],
"packagist.org": false
}
为什么加了双源还是卡 30 秒？
因为 Composer 对每个源单独计时，默认 http.timeout = 30。它不判断连接失败，只等满 30 秒才往下走——哪怕 DNS 解析卡住、TLS 握手慢、IPv6 fallback 延迟，都会拖满这半分钟。
- 临时缓解：
composer config -g http.timeout 600（拉长到 10 分钟） - 更治本：
COMPOSER_IPV4=1环境变量强制走 IPv4，绕过 IPv6 探测（尤其在云主机或校园网） - 验证是否真走镜像：
composer update -vvv | grep mirrors.aliyun.com，别信composer config repo.packagist的输出
别指望靠堆源来提速。加第二个源只在第一个明确返回 404 时生效；其余错误（502/超时/TLS 错误）只会死等，不会 fallback。
生产环境要“极致稳定”，就得绕开 Composer 自身
CI/CD 或 Docker 构建中，composer config --global 常因用户权限、缓存复用、HTTP 缓存（~/.composer/cache）而失效。Composer 2.9.6 依然没有内置重试机制，所以主备必须由外部控制。
- 推荐用
composer-proxy（Go 写的轻量代理），监听127.0.0.1:8080，自动轮询多个镜像并做健康检查 - 或写 shell 脚本：先
curl -I -s -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json，返回 200 再设源，否则 fallback 并 warn - 每次切换后务必执行
composer clear-cache，否则旧镜像元数据残留会导致 404
最常被忽略的一点：你配的所有“多镜像”逻辑，都建立在“镜像服务端能正确响应 404”之上。如果某个镜像对不存在的包返回 502 而不是 404，Composer 就永远卡住，不会查下一个源。
