弱网环境下Composer安装失败主因是中间设备静默断开TCP连接导致复用失效socket，须同步启用keep-alive（仅2.2+支持）、调优connect-timeout/max-retries/process-timeout，并配置穿透服务端心跳，且必须执行composer clear-cache生效。
弱网环境下 Composer 安装失败，90% 不是镜像源慢，而是 TCP 连接被中间设备（NAT、防火墙、穿透代理）静默断开后，Composer 复用已失效 socket 导致 Connection reset by peer 或 cURL error 56: Failure when receiving data from the peer。必须同时调整 HTTP 行为与底层连接策略，单改超时或换源无效。
为什么 keep-alive 必须开启且仅 Composer 2.2+ 支持
Composer 默认禁用 HTTP/1.1 keep-alive，每个包下载都新建 TCP 连接。弱网下建连耗时占比高，且 NAT 设备普遍在 60–300 秒空闲后回收连接。一旦第二个包复用第一个包的 socket，而该 socket 已被中间设备关闭，就会触发重置错误。
-
composer config -g http.keepalive true强制启用长连接，但仅 Composer 2.2+ 的CurlDownloader实现了该配置；旧版本即使设了也无效 - 验证是否生效：运行
composer install -vvv，观察日志中是否出现Connection: keep-alive请求头 - 若用 Composer 2.1 或更早版本，升级优先于调参；执行
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
三个必须同步配置的全局参数
仅开 keep-alive 不够。弱网链路抖动大、握手慢、丢包率高，需收紧连接生命周期控制：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g http.connect-timeout 30：缩短建连等待时间，避免卡在穿透隧道握手阶段（frp/ngrok 建连常 >10s） -
composer config -g http.max-retries 5：默认仅重试 2 次，弱网下易失败；设为 5 可覆盖多数瞬时丢包场景 -
composer config -g process-timeout 0：禁用整体流程超时，防止因单个包下载慢导致整个 install 中断（注意：此值影响的是命令级超时，非 HTTP 层）
穿透服务端（如 frp）必须补的心跳配置
客户端配再好，服务端不保活，连接照样断。以 frp 为例，frps.ini 缺这两项等于白配：
-
heartbeat_timeout = 30：服务端主动探测心跳间隔，必须 ≤ 客户端 keep-alive 发送间隔 -
tcp_keep_alive = true：启用内核级 TCP keepalive，防止 NAT 设备过早回收连接 - 若用 ngrok，需在
ngrok.yml中配tunnel_config: heartbeat_interval: 25s，并确保服务端支持
弱网下仍失败？先关掉这些“优化”
某些看似加速的配置，在弱网下反而加剧失败：
- 禁用
--classmap-authoritative：该模式强制只查 classmap，一旦某个类未被收录（常见于动态 require 或空目录），autoload 就直接报Class not found，掩盖真实网络问题 - 避免
COMPOSER_DISABLE_NETWORK=1：离线模式会跳过所有网络校验，但无法解决 lock 文件与实际包不匹配的隐性错误 - 不要用
composer dump-autoload --optimize替代composer install --optimize-autoloader：前者不重建 classmap，且在 Composer 2+ 中已失效，极易引发 autoload 错误
最易被忽略的一点：所有配置变更后，必须清空 Composer 缓存再试 —— composer clear-cache。否则旧缓存包可能携带已断连的元数据，导致新配置不生效。
