Composer报Could not load metadata等错误大概率是镜像返回的packages.json或p2/xxx.json不符合Packagist Schema规范，需用curl -i验证响应状态、Content-Type及JSON结构，再通过切回官方源+--refresh、VCS覆盖或--no-cache绕过。
Composer 报 Could not load metadata、Invalid argument supplied for foreach() 或静默卡在 Resolving dependencies，大概率不是网络问题，而是你正在解析一个结构非法的 JSON —— 镜像返回的 packages.json 或 p2/xxx.json 不符合 Packagist Schema 规范。
怎么确认是镜像元数据格式错误，不是本地环境问题
别信 Composer 的模糊报错，直接测原始响应：
- 运行
curl -i https://mirrors.aliyun.com/composer/packages.json，检查：HTTP 状态码是否为200（不是301、404、502）；响应头Content-Type是否为application/json；响应体开头是否为{"packages":{ - 对具体包验证：
curl -i https://mirrors.aliyun.com/composer/p2/monolog/monolog.json，同样看是否以合法 JSON 结构开头 - 如果返回 HTML（含
<html>）、空内容、或以{}开头，就是元数据格式错误的铁证 -
composer diagnose里 “PHP binary” 和 “Repo” 行没问题，但composer update -vvv日志中反复出现Downloading https://...后失败，也指向服务端 JSON 异常
为什么国内主流镜像会返回非法 JSON
这不是配置错误，是镜像后端同步或代理链路出问题：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 同步中断后残留半截
packages.json（结尾缺}或]） - 反向代理未配好 URL 末尾斜杠，导致请求被重写成
/composer→/composer/，中间返回 HTML 重定向 - CDN 缓存了上游
502/503错误页，并当作 JSON 返回 - 镜像主动过滤包时，错误返回空对象
{}或null，而非标准{"packages":{}}
绕过非法元数据的三种实操方式（按优先级）
确认是格式错误后，别等修复，立刻切换策略：
- 临时切回官方源 + 强制刷新：
composer config -g repo.packagist composer https://repo.packagist.org，再运行composer update --refresh（仅 Composer ≥ 2.5 支持）；若版本太低，手动删缓存目录：rm -rf $(composer config --global cache-dir)/repo/https---repo.packagist.org - 指定单个包走 VCS 源：在项目
composer.json的repositories数组里加一项：{"type":"vcs","url":"https://github.com/Seldaek/monolog"}，然后composer require monolog/monolog:3.6.0—— 完全绕过镜像的p2/接口 - 禁用缓存直连（调试用）：
COMPOSER_CACHE_DIR=/dev/null composer update -vvv，观察真实请求 URL 是否仍指向坏掉的镜像路径
长期规避：选同步快、容错强的镜像源
中科大源和华为云源目前同步延迟控制在 5 分钟内，比阿里云/腾讯云更激进；但关键不止是“快”，还得看它是否严格校验 JSON 结构：
- 中科大源（
https://mirrors.ustc.edu.cn/composer/）默认开启 JSON 格式校验，非法响应会直接 500 而非返回脏数据 - 华为云源（
https://mirrors.huaweicloud.com/repository/php/composer/）使用独立元数据生成器，不依赖上游 raw 包，结构稳定性更高 - 配置后必须验证：
composer config -g repo.packagist输出应为完整 URL；再跑composer show -p | head -1，第一行域名必须匹配 - 注意：只要项目
composer.json里有repositories字段（哪怕空），全局镜像就彻底失效 —— 这是最常被忽略的覆盖点
真正难处理的不是格式错误本身，而是它往往混在超时、缓存、路径拼接失败等现象里，让人反复折腾 PATH、PHP 版本或镜像地址。最稳的做法永远是：先 curl -i 看原始响应，再决定动哪一层 —— 元数据层的问题，不该用运行时配置去救。
