应使用curl -w实测TTFB，因composer diag仅检测连通性不测延迟；需带Composer User-Agent头、-w "%{time_starttransfer}"提取首字节时间，并用--resolve绕过SNI问题。
怎么用curl实测镜像TTFB，别信composer diag
composer diag只告诉你“能不能连上”，不反映真实延迟。它可能显示 OK，但composer update卡在 Fetching packages.json 12 秒——这 12 秒就是 TTFB（Time to First Byte），得用 curl 实测。
执行这个命令，替换为你当前镜像地址（查法见下一条）：
curl -s -o /dev/null -f \
-H"User-Agent: Composer/2.9.6" \
-H"Accept: application/json" \
-w"TTFB: %{time_starttransfer}s, Total: %{time_total}s\n" \
https://mirrors.aliyun.com/composer/packages.json
- 必须带
-H "User-Agent: Composer/2.x"，否则某些镜像返回 403 或缓存页 -
%{time_starttransfer}是关键指标，反映服务端真正开始响应的时间；超过 1.5s 就已拖慢整个流程 - 如果返回 SSL 错误或超时，先试
--resolve绑定 IP，例如：curl --resolve mirrors.cloud.tencent.com:443:119.29.29.29 ...
怎么确认你当前实际生效的镜像源
很多人改了配置却没生效，因为：repo.packagist（单数）是旧写法，repos.packagist（复数）才是 Composer 2.2+ 的正确键名；项目级 composer.json 中的 repositories 会完全屏蔽全局设置。
分两步查清实际生效源：
- 查全局：运行
composer config -g repos.packagist.url—— 输出应为类似https://mirrors.cloud.tencent.com/composer/ - 查项目：进项目目录后运行
composer config repos.packagist.url—— 若有输出，说明项目级配置优先，全局无效 - 如果任一命令输出为空，说明当前走的是官方源
https://packagist.org，不是中文镜像
怎么比对镜像与官方源的元数据新鲜度
镜像再快，如果同步滞后，composer require vendor/package:dev-main 仍会 fallback 或报 404。这不是网络问题，是数据陈旧。
直接比对两个关键字段：
- 访问
https://packagist.org/packages.json，找"lastUpdated"时间戳 - 访问你的镜像地址对应路径，如
https://mirrors.aliyun.com/composer/packages.json，同样找"lastUpdated" - 差值 > 90 秒即属异常延迟；阿里云通常 ≤ 90 秒，腾讯云高峰时段可能达 3–5 分钟
- 注意：浏览器访问镜像站首页看到的“更新时间”不可靠，必须看
packages.json文件末尾的时间戳
为什么composer config -g repo.packagist总不生效
90% 的失败源于命令写错，它会静默失效，不报错也不提示。必须同时满足三个硬性条件：
-
repo.packagist是唯一合法键名，写成repos.packagist（多一个 s）、packagist（少repo.）或mirror都无效 - 中间的
composer是type值，不可省略；漏掉它，Composer 2.0+ 会 fallback 到官方源 - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json直接 404） - 验证是否成功：运行
composer config -g repo.packagist，输出应为完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍显示https://packagist.org，说明没写进去
实际诊断时，最常被忽略的是 User-Agent 头和 packages.json 中 lastUpdated 字段的比对——这两项不查，光看 curl 连通性或命令是否执行成功，根本没法定位真实瓶颈。
