502 Bad Gateway 表明镜像源后端服务异常，需换用实测可用的 HTTPS 镜像源（如阿里云、华为云、腾讯云），并用 curl -I 和 composer config -g repo.packagist 验证配置正确性。
502 Bad Gateway 是镜像源后端挂了，不是你本地网络或配置的问题；换一个还在维护的 HTTPS 镜像源就能解决，不需要调代理、关 SSL 或重装 Composer。
curl -I 测试镜像源是否真返回 502
Composer 不会告诉你 HTTP 状态码，只笼统报错。必须手动验证镜像根路径：
- 运行
curl -I https://mirrors.aliyun.com/composer/—— 返回HTTP/2 200才算通 - 若返回
HTTP/1.1 502 Bad Gateway或卡住，说明该镜像源后端服务异常，立刻换源 - 别测
https://packagist.org：它在国内多数情况根本连不通，测了也白测 - 注意 URL 末尾必须带
/，https://mirrors.aliyun.com/composer（缺斜杠）会拼出错误路径 → 404
换用实测可用的 HTTPS 镜像源（2026 年 9 月仍在维护）
已停服源（如 https://packagist.phpcomposer.com）和配置错误的 URL 会导致静默 fallback 到官方源，进而触发 502。当前稳定可用的源有：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 阿里云：
https://mirrors.aliyun.com/composer/ - 华为云：
https://mirrors.huaweicloud.com/repository/php/ - 腾讯云：
https://mirrors.cloud.tencent.com/composer/ - 全局切换命令（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist输出应为镜像地址，不是https://packagist.org
临时覆盖源 + -vvv 查看真实响应链路
改错全局配置可能影响 CI 或其他项目，调试阶段优先用 --repository 强制指定：
- 命令示例：
composer install -vvv --repository=https://mirrors.huaweicloud.com/repository/php/ -
-vvv会输出 DNS 解析、TLS 握手、HTTP 状态码等完整链路，一眼看出是 502 还是卡在 TLS 或 DNS -
--repository仅对当次命令生效，不影响任何配置文件 - 务必确认 URL 完整：漏掉
/repository/php/后缀（只写https://mirrors.huaweicloud.com）会直接 404
清缓存 + 检查是否 fallback 到失效源
缓存里存着上次失败的元数据，不清理就会反复走旧路径，看起来像“一直 502”：
- 先执行：
composer clear-cache - 检查是否误配键名：
repo.packagist必须是单数、小写、无s；写成repos.packagist或repo.packagist.org都会静默失效 - type 值不能省：
composer config -g repo.packagist composer ...中间那个composer是 type，必须写 - 检查
composer config -g --list输出，确认没有残留的https-proxy或secure-http false干扰判断
最容易被忽略的是：你以为切了镜像，其实因为键名写错或少了个 /，Composer 已经默默 fallback 回 packagist.org——而它在国内返回 502 的概率极高。验证必须落到 curl -I 和 composer config -g repo.packagist 这两行命令上，别信感觉。
