镜像 url 必须以尾斜杠结尾，否则 composer 会拼接错误路径导致 404 并静默回退到 packagist.org；生效需验证 config 输出为完整 json 对象；nginx 反代、dist 路径一致性、sha256 校验、只读时间戳路径、repositories 非 fallback 列表、http/2 server push 无效——仅 dns、连接复用与 packages.json 体积影响性能。
镜像 URL 必须带尾斜杠，否则 404 后静默 fallback 到 packagist.org
Composer 拼接 packages.json 路径时，会直接把配置的 URL 和路径硬连——比如你配成 https://edge-mirror.local/composer（缺末尾 /），它就会请求 https://edge-mirror.local/composerpackages.json，结果 404。此时 Composer 不报错，而是自动退回到 packagist.org 继续拉取，整个过程不提示、不记录，只在 -vvv 日志里能看到真实请求地址跳转。
真正生效的写法只有这一种：composer config -g repo.packagist composer https://edge-mirror.local/composer/（注意结尾的 /）。
- 验证是否生效：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，形如{"type": "composer", "url": "https://edge-mirror.local/composer/"} - 别信“我执行过了”，
composer diagnose显示 “Repo packagist.org is default” 就说明没生效 - 边缘节点上若用 Nginx 反代，确保
location /composer/能正确路由到后端服务，且静态文件可被GET直达
元数据索引（packages.json）必须与 ZIP 包路径严格对应，否则签名校验静默失效
边缘节点不能只换镜像 URL，必须保证 packages.json 中每个包的 dist.url 字段指向的 ZIP 路径，和实际文件存放位置完全一致。公共镜像常缺失 dist.shasum 字段，导致 Composer v2 在校验失败时静默降级为无签名模式——你看到 composer install 成功，但加载的可能是被篡改过的包。
正确做法是硬编码带时间戳的只读路径，例如："url": "https://edge-mirror.local/2026-06-15"，该路径下必须同时存在：
packages.jsondists/vendor/package/version/hash.zip- 对应每个
dist.shasum值（由 Nginx 网关在响应头或文件旁提供 SHA256 校验值）
任何动态路径（如 /latest、/stable）都会破坏快照一致性，离线部署即崩。
repositories 数组不是故障转移列表，超时或 5xx 直接报错退出
很多人误以为把多个镜像写进 repositories 就能自动 fallback，其实 Composer 的逻辑是：按数组顺序请求每个源的 packages.json，合并成一张索引表；安装时只从第一个声明了该包完整版本信息的源拉 ZIP，其余源完全不参与下载。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
网络错误处理极其严格：
-
timeout、502、503、DNS 失败 → 直接中断，不尝试下一个源 - 仅当某源明确返回
404（表示“此包不存在于该源”）→ 才查下一源是否声明了它 - 所以边缘节点若配了私有源 + 阿里云镜像，私有源一超时，整个
composer install就卡死或失败
真要实现故障转移，得靠外部插件，比如 yunwuxin/composer-plugin-mirror，它接管下载逻辑，在 ZIP 下载失败时才按序尝试备用镜像。
HTTP/2 Server Push 对 Composer 完全无效，别浪费精力配
Composer 是纯 CLI 工具，每次命令都是一次性发起若干独立 HTTP 请求（如 GET /packages.json），请求结束即断开连接。它没有长连接、不监听响应流、不解析 Link: rel=preload，更不会接收或缓存服务端主动推送的数据。
即使你的边缘网关启用了 HTTP/2 + Server Push，Composer 也完全感知不到——底层 PHP cURL 扩展根本不会把推送流暴露给上层逻辑。
真正影响元数据加载速度的，只有三件事：
- DNS 解析是否稳定（建议预填 hosts 或用本地 DNS 缓存）
- TCP/TLS 连接是否复用（确保镜像域名固定、证书有效、不频繁重定向）
-
packages.json文件体积是否够小（删掉非必要 provider、禁用冗余字段）
想提速？删掉所有 Server Push 配置，专注优化这三项。否则你调得再细，Composer 也收不到一个字节的“推送”。
