“镜像快”不等于“镜像稳”，因稳定性取决于元数据一致性、证书链有效性与CDN容灾能力，而非单次响应耗时；阿里云偶发凌晨502、华为云分片延迟致429、腾讯云不存档已删包，且配置生效需同时满足JSON格式正确、无项目级覆盖、清缓存及日志验证。
为什么“镜像快”不等于“镜像稳”
很多人测出阿里云 packages.json 响应时间最短，就默认它最稳，结果 CI 构建时突然报 Connection refused 或 SSL certificate problem。稳定性不是看单次 curl 耗时，而是看元数据一致性、证书链有效性、CDN 节点容灾能力这三件事。清华源在 IPv6 网络下更稳，是因为其 CDN 对双栈支持更成熟；腾讯云南方节点延迟低，但教育网部分出口 DNS 解析会 fallback 到不可靠上游——这些都不会体现在 curl -w '%{time_total}' 里。
阿里云、华为云、腾讯云镜像的实际失效场景
三家都同步 packagist.org，但同步策略和存储结构不同，导致某些错误只在特定镜像出现：
- 阿里云：华北节点偶发
502 Bad Gateway，多见于凌晨同步窗口（02:00–04:00），此时composer install会静默 fallback 到官方源，但因锁文件含旧哈希，最终卡在Loading package information - 华为云：全量保留历史包，但
metadata请求走分片存储，composer update时若遇到大量未缓存的p2/xxx.json，会出现间歇性429 Too Many Requests（非限流，是分片协调延迟） - 腾讯云：不保留已删包，一旦原作者
abandon某个 v3.4 的包，镜像不会存档，composer install直接报Could not find package xxx，而阿里云/清华源可能还缓着
验证镜像是否真在用，而不是“配置了却没生效”
运行 composer config -g repo.packagist 输出非空 ≠ 镜像正在工作。真正生效必须同时满足：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g repo.packagist输出为完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 项目根目录下没有
repositories字段（或为空对象{}），否则全局配置被完全忽略 - 执行
composer clear-cache后再跑composer install -vvv，日志中必须出现mirrors.aliyun.com或对应域名，且无packagist.org的 DNS 查询痕迹 - 检查
~/.composer/cache/repo/https---mirrors-aliyun-com-composer/目录是否存在且有近期更新的packages.json文件
老项目切镜像最容易踩的兼容性坑
Composer 2.2+ 默认启用 packagist.org 隐式兜底，但老项目 composer.lock 里的 content-hash 是 32 位 md5，且 dist URL 记录的是官方地址。此时即使你配了阿里云镜像，composer install 仍会尝试从 packagist.org 验证元数据——而镜像若未同步该旧包（比如 symfony/console v3.4），就会直接失败。
解决方式不是换源，而是显式禁用兜底：
- 进老项目根目录，运行
composer config repositories.packagist.org false（注意是repositories.packagist.org，不是repo.packagist） - 该命令会在
composer.json中写入"repositories": {"packagist.org": false}，强制 Composer 完全跳过官方源验证 - 之后再执行
composer install，它就只认composer.lock里记录的原始 dist URL 和 hash，不再查镜像元数据
这个细节常被忽略：镜像稳定性的最大变量，往往不是源本身，而是你有没有让 Composer 放弃对它的元数据依赖。
