502错误主因是镜像URL格式错误而非网络问题，需确保repo.packagist配置为完整JSON、URL末尾带斜杠、键名无s、type显式设为composer，并切换至稳定地域节点（如华北/深圳），同时清空repo/缓存目录。
Composer install报502不是网络问题，是镜像URL写错了
502 Bad Gateway在Composer场景下几乎从不表示你本地网络异常，而是镜像源返回了无效响应——根源90%出在repo.packagist配置的URL格式错误。Composer会静默拼接路径，比如把https://mirrors.aliyun.com/composer（缺末尾/）变成https://mirrors.aliyun.com/composerpackages.json，直接404或502。
验证方式极简单：composer config -g repo.packagist输出必须是完整JSON对象，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果只输出字符串（如"https://mirrors.aliyun.com/composer"），说明第三参数composer被漏掉，配置根本没生效。
- URL末尾必须带
/：✅https://mirrors.aliyun.com/composer-cn-beijing/，❌https://mirrors.aliyun.com/composer-cn-beijing - 别用
repos.packagist（多一个s）：Composer 2.x完全忽略这个键名 - 别指望自动fallback：写两个URL会静默覆盖，只认最后一个
阿里云默认CDN节点不稳定，换华北/深圳地域节点
官方推荐的https://mirrors.aliyun.com/composer/走华东CDN，回源抖动时高频触发502；实测更稳的是具体地域节点，比如华北或深圳。
执行以下任一命令切换（注意末尾/）：
- 华北节点：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer-cn-beijing/ - 深圳节点：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer-cn-shenzhen/
验证是否生效：composer install -vvv 2>&1 | grep 'Downloading'，第一行应显示镜像域名+/packages.json，而不是packagist.org。
缓存里存了坏响应，清缓存要清到repo/目录
composer clear-cache默认只清files/和部分快照，但502响应体可能已被误存进repo/子目录，后续请求直接读缓存、根本不发HTTP请求——这才是“换了源还报502”的根本原因。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
暴力清空对应镜像缓存：
- Linux/macOS：
rm -rf $(composer config cache-dir)/repo/https---mirrors-aliyun-com-composer - Windows：
del /s /q "%LOCALAPPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer" - 最彻底方案（会丢失所有已下载包）：
rm -rf $(composer config cache-dir)
临时绕过缓存验证：composer install --no-cache --prefer-dist -vvv，看是否还502。
别在502时跑composer update
composer update在dist包不可用时会fallback到source（git clone），可能暴露SSH密钥或触发其他权限问题。502出现后第一反应不是升级依赖，而是确认源可用性。
优先做三件事：
- 用
curl -I https://mirrors.aliyun.com/composer/直连测试，看是否返回HTTP/2 200 - 临时绕过配置：
composer install -vvv --repository=https://mirrors.huaweicloud.com/repository/php/ - 检查
composer.json里有没有硬编码的repositories，它优先级低于全局配置，但容易干扰判断
真正麻烦的是缓存路径里混着多个镜像的失败响应，手动删错目录比重装Composer更常见。
