镜像节点502错误主因是地域节点选错而非网络问题，应切换至稳定地域url（如阿里云华北节点）、清缓存并修正权限；composer不支持自动fallback，需手动配置具体节点且url末尾带斜杠。
镜像节点 502 错误不是网络问题，是节点选错
Composer 报 502 Bad Gateway 卡在 downloading 阶段，90% 不是你本地网络差，而是镜像 URL 指向了一个不稳定地域节点。比如用 https://mirrors.aliyun.com/composer/ 默认走华东 CDN，遇到回源抖动就直接 502；但华北节点 https://mirrors.aliyun.com/composer-cn-beijing/ 同一时刻可能完全正常。
别指望 Composer 自动 fallback —— 它压根不支持多源容灾，repo.packagist 只接受单个字符串值，写两个 URL 会静默覆盖。
- 确认当前生效镜像：
composer config -g repo.packagist，输出必须是完整 JSON 且url字段为你填的地址（结尾带/） - 立刻清缓存：
composer clear-cache，否则旧元数据仍会尝试访问失效节点 - 切具体地域节点 URL，例如阿里云华北：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer-cn-beijing/ - 验证是否生效：跑
composer install -vvv，盯日志第一行是否为Downloading https://mirrors.aliyun.com/composer-cn-beijing/packages.json
下载中断后怎么跳过已损坏的 ZIP 包
缓存里存了半截 ZIP 文件，下次 composer install 会直接读它，校验失败就报 Corrupted zip file 或 Invalid zip or corrupt data，根本不会重下。
单纯 composer clear-cache 有时不够——它只清 ~/.composer/cache/files/ 和 packages.json 快照，但某些损坏包可能卡在中间状态没被清理干净。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动删掉对应包的 ZIP：
rm -f $(composer config cache-dir)/files/vendor-name/package-name/*.zip - 或者暴力清空整个 files 目录：
rm -rf $(composer config cache-dir)/files - 加
--no-cache强制绕过缓存：composer install --no-cache --prefer-dist，避免任何本地残留干扰 - 注意：
--prefer-dist能避开 git clone 触发的 GitHub API 限流，比--prefer-source更稳
为什么 composer update 会让问题更糟
遇到损坏包时，很多人第一反应是 composer update，结果反而暴露凭据或触发更深层错误。这是因为 update 在 dist 包不可用时，会 fallback 到 source（即 git clone），而：
- 私有仓库的 SSH 凭据可能被暴露在日志里
- GitHub API 有调用限额，频繁 clone 容易触发
403 rate limit exceeded - 如果
composer.lock里记录的 dist URL 已被镜像移除，update会反复尝试、卡死，而不是跳过 - 真正安全的做法是
composer update --lock：它只重算composer.lock中的dist.sha256和size字段，不动vendor/里的文件
缓存权限错位导致“假损坏”
报错含 failed to write 或 Permission denied，90% 是属主错位，不是镜像坏。尤其常见于 Docker、CI/CD 或 WSL 环境。
- 查缓存路径：
composer config --global cache-dir - 看属主：
ls -ld $(composer config --global cache-dir) - 修权限（非 root 用户）：
sudo chown -R $USER:$USER $(composer config --global cache-dir) - WSL 用户额外检查
/etc/wsl.conf是否启用metadata，否则chmod无效 - 顺手修整个配置目录：
sudo chown -R $USER:$USER ~/.composer
镜像节点本身没有“跳过”机制，所谓跳过，本质是换节点 + 清残留 + 避开权限陷阱三件事同时做对。漏掉任意一环，都可能让同一个错误反复出现。
