Composer repositories数组不是负载均衡配置,而是线性短路查找:仅按顺序请求packages.json,首个成功解析的源即被锁定使用,后续全部跳过,不并发、不重试、不健康检查、无权重分流。

Composer 没有负载调度机制,所谓“多源负载均衡”是常见误解;它只做顺序短路查找,不并发请求、不失败重试、不权重分流。
为什么 repositories 数组不是负载均衡配置
Composer 的 repositories 是纯线性扫描逻辑:从数组索引 0 开始,对每个仓库发起 GET packages.json 请求,第一个返回 HTTP 200 且响应体能被 JSON 解析的仓库,就立即锁定使用,后续全部跳过。这和 Nginx 的 upstream 或 DNS 轮询完全不同。
- 没有并发:不会同时向多个仓库发请求
- 没有 fallback:不是“这个挂了换下一个”,而是“这个命中了就不用下一个”
- 没有健康检查:不判断响应时间、不记录失败次数、不标记临时不可用
- 不支持
weight、priority、max_fails等任何调度参数
type: "composer" 源必须显式声明包名才能“被命中”
私有 Composer 源(如 Satis、Private Packagist)要参与顺序匹配,前提是它的 packages.json 文件中 providers 字段明确列出了目标包,例如:
{
"providers": {
"acme/utils": {
"sha256": "..."
}
}
}
如果该文件里没写 "acme/utils",哪怕 URL 可访问、HTTP 状态正常,Composer 也会跳过它,继续查下一个源——这不是“调度失败”,而是“根本不匹配”。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
require-all: true在 Satis 构建时才起作用,生成的packages.json必须已包含目标包 - 运行
composer update -vvv acme/utils可看到实际匹配日志,确认是否真被该源提供 - VCS 类型(
type: "vcs")不走此流程,只对composer require acme/utils显式调用生效
想实现类负载效果?只能靠外部手段绕过 Composer 原生逻辑
真要分摊请求压力或容灾,得在 Composer 之外加一层:比如反向代理、CDN 或 DNS 轮询,让多个物理地址共用一个逻辑 URL。
- 把所有私有源部署在同一域名下(如
https://repo.internal.company/),后端用 Nginx 或 Traefik 做轮询或主备切换 - 用 CDN 缓存
packages.json和 ZIP 包,降低源站压力,但需注意缓存失效策略 - 禁用
packagist.org后,repositories里只保留一个type: "composer"源,避免“看似多源实则单点”带来的误判 - 不要试图用多个同类型源(如两个 Satis 实例)写进
repositories并指望自动分流——它们只是排队,不是并行
最常被忽略的一点:你改了 repositories 顺序,却没验证 packages.json 是否真含目标包;或者用了 HTTPS 私有源但忘了配 ssl.cafile,导致第一个源静默失败而跳到第二个——看起来像“调度”,其实是证书错误引发的误跳。










