答案是旧版Composer 1.x（如1.10.22）无法解析国内镜像精简后的packages.json结构，因裁剪conflict、require-dev等字段或改写providers数组为单个provider字段，触发UnexpectedValueException报“Could not parse version constraint”。
Composer 1.x 解析精简元数据直接崩溃
旧版 Composer（尤其是 1.10.22 及更早）只认 Packagist 官方 packages.json 的完整字段结构。阿里云、腾讯云等镜像为加速会裁剪非必需字段（如 conflict、require-dev），或把 providers 数组改成单个 provider 字段——这会让 Composer 1.x 在解析阶段抛 UnexpectedValueException，表现为 Could not parse version constraint。
你不是“换错了镜像”，而是旧版 Composer 和国内镜像的元数据协议不兼容。每次换镜像，只要它返回的是精简版 JSON，就会触发一次崩溃。
- 验证方式：运行
composer config -g repo.packagist，如果输出里url指向国内镜像，且 Composer 版本 ≤ 1.10.22，基本就是这个原因 - 临时解法：升级到 Composer 2.x（
composer self-update），它支持宽松解析 - 保守解法：切回官方源 + 清缓存：
composer config -g repo.packagist composer https://packagist.org，再执行composer clear-cache
镜像 URL 缺尾部斜杠引发无限重定向
所有主流中文镜像（阿里云、华为云、腾讯云）都要求镜像地址以 / 结尾。漏掉就触发服务端 301 重定向：GET /composer → 301 → /composer/ → Composer 再次发 GET /composer……形成死循环，最终报 redirect 错误或静默卡住。
错误配置示例：https://mirrors.aliyun.com/composer（缺 /）；正确写法必须是：https://mirrors.aliyun.com/composer/。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -I -L https://mirrors.aliyun.com/composer/packages.json直接看跳转链，如果 Location 在两个地址间反复跳，就是这个原因 - 项目级配置中若混用了私有源，
composer config repo.packagist还可能覆盖整个repositories数组，意外删掉私有源 - 环境变量
COMPOSER_REPO_PACKAGIST优先级高于全局配置，容易被忽略
缓存污染导致元数据与锁文件不匹配
换镜像后报 checksum mismatch 或 Invalid argument supplied for foreach()，往往不是镜像本身问题，而是本地 composer.lock 里存着旧包哈希，而新镜像已同步了新版包文件——校验值对不上，Composer 就拒绝安装。
composer clear-cache 只清下载缓存，不碰 composer.lock；只删 vendor/ 目录也没用，因为 install 仍会按旧 lock 文件去校验。
- 唯一有效操作：同时删除
vendor和composer.lock（先备份：cp composer.lock composer.lock.bak） - 删完立刻用官方源重装：
composer config -g repo.packagist composer https://packagist.org，再composer install，生成全新 lock 文件 - 确认镜像同步完成后再切回：阿里云一般延迟 10–30 分钟，中途硬切会导致元数据和包文件状态不一致
镜像返回 HTML 页面而非 JSON 数据
当镜像服务临时不可用、DNS 被劫持、或 CDN 缓存了 502 页面时，Composer 会收到 HTML 响应（比如含 <html><title>502 Bad Gateway</title>），然后尝试用 json_decode() 解析，直接报 SyntaxError: Unexpected token < in JSON at position 0。
这不是你 composer.json 写错了，也不是 PHP 环境问题，而是网络层返回了非 JSON 内容。
- 快速验证：从报错日志里提取请求 URL（如
https://mirrors.aliyun.com/composer/p2/vendor/package.json），用curl -sS直接访问，看返回是不是纯 JSON - 检查
composer config --list中repo.packagist的值是否有拼写错误（如phpcomposr少字母） - 某些企业网络会强制将 HTTPS 降级为 HTTP，而 Composer 默认不跟 HTTP 跳转，也会卡在 redirect
