Connection reset by peer 是中间设备（如防火墙、网关、NAT）主动发RST包中断TCP连接，并非Composer自身断开；需禁用keep-alive、验证镜像URL末尾带/、检查权限污染与缓存错位。
Connection reset by peer 是网关在中断连接
这不是 Composer 自己断开，而是请求发出去后，被中间设备（比如企业防火墙、校园网网关、云主机 NAT 设备）主动发 RST 包重置了 TCP 连接。现象是 composer install -vvv 日志里反复出现 Retrying，但卡在 Connected to mirrors.aliyun.com 后就没了下文，或直接报 Connection reset by peer。
常见诱因包括：
- 网关对 HTTPS 连接复用做了限制，cURL 默认 keep-alive 被中间设备误判为“长连接攻击”
- DNS 解析正常，但 TLS 握手阶段被拦截（尤其 SNI 字段被识别后丢弃）
- 镜像 URL 拼写错误导致请求路径非法，网关返回 RST 而非 404
停掉 --retries，先验证镜像真实可用性
重试参数对 Connection reset by peer 完全无效——它属于不可恢复错误，Composer 只会不断重放同一失败请求。必须手动确认镜像根路径是否真能通：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
curl -I https://mirrors.aliyun.com/composer/，必须秒回HTTP/2 200；返回403、502或卡住，说明网关已拦截该域名或路径 - 注意 URL 末尾必须带
/：写成https://mirrors.aliyun.com/composer（缺斜杠）会导致 Composer 拼出/composerpackages.json，触发非法路径拦截 - 别测
packagist.org，它在国内基本不可达，测了只会误导你去调本地配置
强制禁用 keep-alive 绕过连接复用劫持
很多企业网、校园网、阿里云轻量应用服务器会出现“复用连接被 RST”的典型现象。此时需让 cURL 每次都新建连接，避开中间设备的连接池策略：
- Linux/macOS 临时生效：
CURL_OPTIONS="--no-keepalive" composer install - Windows PowerShell：
$env:CURL_OPTIONS="--no-keepalive"; composer install - 该参数会让每次 HTTP 请求都走全新 TCP 握手，略微增加耗时，但在高干扰网络下失败率可从 >80% 降至接近 0%
- 不要设为全局默认，仅用于排查和 CI 构建阶段
检查权限污染和缓存错位这两个静默杀手
很多人反复重试却始终失败，其实是环境状态被破坏：执行 ls -ld vendor/ composer.lock $(composer config --global cache-dir)，若任一路径属主是 root，说明之前误用了 sudo composer install，导致 Composer 在部分路径下以 root 权限写入，后续普通用户无法覆盖或读取。
- 项目内修复：
sudo chown -R $USER:$USER vendor/ composer.lock - 全局缓存修复：
sudo chown -R $USER:$USER $(composer config --global cache-dir) - 如果整个
~/.composer都归 root，直接删掉再重来：rm -rf ~/.composer，然后重新配镜像
真正卡住的地方往往不是 Composer 本身，而是它依赖的底层网络行为和文件系统归属——连不上、写不了、读不到，三者只要占一个，Connection reset by peer 就会反复出现，且日志不提示具体路径。
