确认镜像metadata损坏需用curl -i验证packages.json响应：状态码非200、Content-Type非application/json或响应体非{"packages":{开头即为铁证，清缓存无效因损坏数据已缓存在~/.composer/cache/repo/下。
中文镜像返回的包描述数据损坏，不是镜像“内容错”，而是它返回了非法 JSON 或 HTML 响应——必须用 curl -i 直接验证元数据接口，再针对性绕过。
怎么确认是镜像 metadata 损坏，而不是网络或本地问题
别看 Composer 报错就清缓存、删 vendor。先验证镜像本身是否在返回垃圾数据：
- 运行
curl -i https://mirrors.aliyun.com/composer/packages.json，检查三件事：HTTP 状态码是不是200、Content-Type头是不是application/json、响应体开头是不是{"packages":{ - 如果返回
301（重定向）、502（上游错误）、text/html（HTML 页面）或空内容/只有{}，就是镜像元数据损坏的铁证 - 对具体包测试也一样：
curl -i https://mirrors.aliyun.com/composer/p2/monolog/monolog.json，看结构是否合法
为什么换镜像或 clear-cache 通常没用
因为问题不在缓存 ZIP 包，也不在你本地配置写错了——而在于 Composer 已经把损坏的 packages.json 或 p2/*.json 下载并缓存到了 ~/.composer/cache/repo/ 下，且默认 15 分钟内不会过期。这个缓存不归 composer clear-cache 管，它只清 files/ 目录下的 ZIP。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer clear-cache不会动repo/下的元数据快照 - 改镜像地址后，如果旧缓存没刷新，Composer 还是读那个损坏的
packages.json，根本不会去新地址拉 - 项目级
composer.json里写了空"repositories": []，会直接屏蔽全局镜像配置，强制回退到官方源
三种能立刻见效的绕过方式
当确认镜像返回非法 JSON，又等不及修复时，按优先级选一种：
- 临时切回官方源 + 强制刷新：
composer config -g repo.packagist composer https://repo.packagist.org，再跑composer update --refresh（≥2.5）；或者手动删掉~/.composer/cache/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/接口 - CI/CD 中高频构建时，别复用
~/.composer/cache，改用COMPOSER_CACHE_DIR=$(mktemp -d) composer install --no-cache，确保每次都是干净元数据起点
最容易被忽略的细节
很多人以为只要 composer config -g repo.packagist 输出了 URL 就生效了，但实际可能被环境变量覆盖：env | grep COMPOSER_REPO 如果输出 COMPOSER_REPO_PACKAGIST=http://...，说明用了 HTTP 协议，而当前网络策略很可能拦截非 HTTPS 请求，造成静默失败。另外，URL 必须以 / 结尾，少一个斜杠就会拼成 https://mirrors.aliyun.com/composer/packages.json → 404。
