composer 404主因是镜像url缺末尾斜杠、使用已下线旧源或键名/type配置错误；须用curl -i验证连通性，删vendor和composer.lock后重装，并确保config -g repo.packagist输出含带/的https完整json。
镜像URL末尾少斜杠导致404错误
Composer拼接元数据路径时，会把配置的URL和固定后缀packages.json直接拼接。如果配成https://mirrors.aliyun.com/composer（缺/），实际请求的就是https://mirrors.aliyun.com/composerpackages.json——这个地址根本不存在，返回404。但Composer不报错，只卡在Loading composer repositories阶段。
- 正确写法必须带末尾斜杠：
https://mirrors.aliyun.com/composer/ - 验证方式：运行
composer config -g repo.packagist，输出应为完整JSON，含"url": "https://mirrors.aliyun.com/composer/" - curl手动测试：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200
用了已下线或协议错误的镜像地址
像https://packagist.phpcomposer.com或http://packagist.laravel-china.org这类旧源，早已返回404或重定向到HTML页面。Composer拿到非JSON响应后，无法解析包列表，后续下载全部失败，日志里可能出现JSON decode error或file_put_contents(): Only variables should be passed by reference这类误导性报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 阿里云、清华TUNA、腾讯云是当前稳定可用的主流镜像
- 必须用HTTPS：Composer 2.9+已拒绝HTTP地址，会静默fallback到官方源
- 避免人机验证页：手动
curl -I测试镜像根URL，返回头里不能含text/html
键名写错导致全局配置完全失效
写成repos.packagist（多一个s）或repositories.packagist.org（Composer 2.2+才支持），Composer 2.x会直接忽略整条配置，安静退回https://packagist.org。它不报错、不提示，只让你无限等待。
- 唯一合法键名是
repo.packagist（单数，无s） - 必须显式传入
composer作为type值：composer config -g repo.packagist composer https://... - 项目级配置优先级更高：只要
composer.json里有"repositories"字段（哪怕空数组[]），全局设置就彻底失效
镜像同步延迟引发ZIP包404
元数据（packages.json）更新快，但dist ZIP包可能滞后几分钟。Composer拿到新版本号后，去镜像站拉对应ZIP，结果返回404。这不是网络问题，而是镜像站缓存未就绪。
- 现象：报
Failed to download vendor/package: file not found或具体ZIP URL 404 - 临时绕过：
composer install --no-cache --verbose看失败URL，再curl -I确认是否真不存在 - 紧急方案：切回官方源单次安装：
composer config -g repo.packagist composer https://packagist.org
composer config -g repo.packagist和composer install -vvv | grep Downloading，两行命令就能暴露真实请求地址。镜像配置不是“设了就行”，是四个硬条件（键名、type值、末尾斜杠、HTTPS）全满足才算生效。
