答案：因镜像返回非法json（如html错误页、空响应或{}开头），导致composer解析失败；需用curl验证状态码、content-type及响应体结构，并切回官方源清缓存修复。
镜像源配置本身不能防源站崩溃，真正起作用的是 composer.lock + 本地缓存 + 显式镜像 URL 三者组合；单独换镜像却没固化 lock 文件，等于裸奔。
为什么切镜像后依然报 Could not load metadata
这不是网络不通，而是镜像返回了非法 JSON——比如 packages.json 是 HTML 错误页、空响应、或以 {} 开头。Composer 解析时直接 panic，报错如 Invalid argument supplied for foreach() 或 JSON decode error。
- 用
curl -i https://mirrors.aliyun.com/composer/packages.json验证：状态码必须是200，Content-Type: application/json，响应体必须以{"packages":{开头 - 若返回
或301 Moved Permanently，说明镜像反向代理层出问题，不是你网络或 Composer 版本的问题 - 同理检查具体包：
curl -i https://mirrors.aliyun.com/composer/p2/monolog/monolog.json，结构异常会卡在单个包上
临时切回官方源并强制刷新元数据
当确认镜像返回非法 JSON，又无法立刻换源时，最稳的兜底动作是切回官方源并清掉已损坏的元数据缓存：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 composer https://repo.packagist.org（注意末尾/和中间composer类型标识） - 运行
composer update --refresh（≥ 2.5 才支持）；若版本低，手动删缓存目录：rm -rf ~/.composer/cache/repo/https---repo.packagist.org/ - 不推荐用
--no-cache，它跳过所有缓存但不修复元数据路径，仍可能复现崩溃
项目级 repositories 覆盖全局配置的风险
只要 composer.json 里有 repositories 字段，全局镜像就完全失效——而且 Composer 不提示、不警告、不 fallback。
- 常见错误：
"repositories": [{"type": "composer", "url": "https://packagist.org"}]→ 实际走的是官方源，你以为在用镜像 - 更危险的是：
"repositories": {"packagist.org": false}→ 直接禁用 Packagist，连ext-json这类 PHP 内置扩展校验都会失败 - 安全写法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会往repositories里插入正确结构
CI 环境中真正的高可用不是靠多镜像，而是靠重试 + 缓存挂载 + lock 固化
Composer 本身不支持自动 fallback，所谓“多镜像配置”在 repositories 里只是按序匹配，第一个能连通且含包的就用，不会失败后试下一个。
- CI 脚本里加 shell 重试逻辑：
for mirror in "https://mirrors.aliyun.com/composer/" "https://packagist.mirrors.ustc.edu.cn/"; do composer config -g repo.packagist composer "$mirror" && break || sleep 2; done - 必须挂载
~/.composer/cache到 CI 容器，否则每次都是干净环境，缓存全丢 -
composer.lock必须提交进 Git，它是唯一能让composer install完全离线运行的文件；没它，任何镜像都救不了源站宕机
最容易被忽略的点：镜像同步延迟和元数据 Schema 合规性是两回事。一个镜像可能同步快，但某次中断后返回半截 JSON；另一个同步慢，但结构始终合法。日常演练时，别只测响应速度，一定要用 curl -i 抓原始响应看 body 结构。
