解决网络抖动导致Composer镜像源同步中断的问题-composer-PHP中文网

composer下载中断主因是元数据缓存未刷新与tls复用失败；需验证镜像配置是否生效、手动清理repo缓存目录、并用composer update --refresh强制重拉packages.json等元数据。

解决网络抖动导致composer镜像源同步中断的问题

直接换镜像源不能解决同步中断——它只改了请求目标，没动 Composer 的元数据缓存策略和并发行为。真正卡住你的，是 packages.json 本地缓存过期后仍被复用，加上并发下载触发 TLS 复用失败，导致中途 reset 或 timeout。

确认当前镜像是否真被调用

很多人执行了 composer config -g repo.packagist 就以为万事大吉，但实际日志里仍是 Downloading https://packagist.org/packages.json。原因有三：

项目级 composer.json 中存在 "repositories" 字段（哪怕只是空数组 []），会完全屏蔽全局配置
键名写错：repos.packagist（复数）才是 Composer ≥ 2.2 的正确键，repo.packagist 在新版中静默忽略
URL 缺少末尾斜杠：https://mirrors.aliyun.com/composer ❌ 返回 404；https://mirrors.aliyun.com/composer/ ✅ 才有效

验证方式：运行 composer install -vvv | head -n 5，第一行 URL 必须是镜像域名；再执行 composer config -g repo.packagist，输出必须是完整 JSON 对象或带斜杠的 HTTPS URL。

清理元数据缓存，不是 `clear-cache`

composer clear-cache 只删 ZIP 包和部分文件缓存，对决定“有没有这个包”的 packages.json 和 provider-*.json 几乎无效。这些文件藏在 ~/.composer/cache/repo/https---mirrors-aliyun-com-composer/ 这类路径下（URL 中的 / 被转义为 ---）。

先查路径：composer config --global cache-dir
再进 repo/ 子目录，找对应镜像的转义目录：ls -d $(composer config --global cache-dir)/repo/https---*
手动删掉整个目录：rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
Windows 用户路径类似：%APPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer

删完立刻跑 composer show monolog/monolog，Composer 才会重新拉取最新元数据。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

强制刷新元数据，跳过本地缓存逻辑

Composer ≥ 2.5 提供了精准解法：composer update --refresh。它不重下 ZIP 包，只丢弃所有缓存的元数据文件（packages.json、provider-*.json），并从当前生效镜像源强制重拉。

执行前务必确认：composer config -g repo.packagist 输出是你期望的镜像地址
若项目有 repositories 字段，需临时去掉或显式加回 packagist 镜像条目
加 --no-cache -v 可看到终端输出的真实请求 URL，确认是否命中镜像
老版本（--refresh 不存在

这比反复 clear-cache 或删 vendor 高效得多，也避免误删已验证可用的 dist 包。

调低并发与协议强度防中间设备截断

Connection reset by peer 不是镜像挂了，而是企业防火墙、校园网网关在 TLS 握手或 HTTP/2 协商阶段主动 RST。Composer 默认启用并行下载和 HTTP/2，加剧了这类问题。

关并行：composer config -g http-max-concurrent-downloads 1（注意不是 parallel-downloads，该参数已弃用）
降级 HTTP：composer config -g http.http_version 1.1（需 Composer ≥ 2.5）
指定 TLS 版本（写入 ~/.composer/config.json）："options": { "ssl": { "crypto_method": 3072 } }（3072 = TLSv1_2_METHOD）
CI 环境建议统一用环境变量：COMPOSER_REPO_PACKAGIST=composer=https://mirrors.aliyun.com/composer/

这些调整不改变镜像地址，但让每次请求更“老实”，避开中间设备的兼容性雷区。

最易被忽略的是：元数据缓存路径和镜像 URL 强绑定，删错目录等于白干；而 composer diagnose 默认测的是 packagist.org，根本不管你的镜像是否通——别被它骗。