composer部署失败主因是网络丢包导致http连接重置，非其自身逻辑问题；应强制--prefer-dist、启用composer_retry=3、调大composer_http_timeout=600、禁用http/2和tls 1.3，并预检网络稳定性。

Composer 项目部署本身不涉及软路由或网络丢包的主动防御——它只是 PHP 的依赖管理工具，composer install 或 composer update 过程中发生的连接重置，根源在 HTTP(S) 请求层（如 cURL、PHP stream context 或底层 TCP），而非 Composer 自身逻辑。真正要防的，是网络不稳定时的失败雪崩。

为什么 composer install 会因丢包失败

Composer 默认通过 HTTPS 从 packagist.org 或私仓拉取 composer.json 中声明的包元数据（packages.json）和 ZIP 包，整个过程包含多次 HTTP 请求：获取锁文件、解析依赖树、下载 dist ZIP、校验 SHA256。任一请求中途被软路由丢包/超时/TCP RST，就会中断并报错，常见如：

Connection reset by peer、Failed to enable crypto、cURL error 56: SSL read: errno=104、file_get_contents(): SSL: Connection reset by peer

这类错误不是 Composer bug，而是网络链路（尤其经过 NAT 型软路由、QoS 限速、MTU 不匹配或防火墙状态跟踪失效）导致的底层连接异常。

改用 --prefer-dist + 自动重试策略

默认情况下 Composer 可能回退到 --prefer-source（git clone），而 git 协议更易受丢包影响（TCP 长连接、无内置重试）。强制走 dist 模式可减少交互次数，且 ZIP 下载支持分块续传和更可控的 HTTP 客户端行为。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

• 始终加 --prefer-dist 参数：composer install --prefer-dist --no-interaction
• 启用内置重试（Composer ≥ 2.2）：COMPOSER_RETRY=3 composer install（默认仅重试 2 次，设为 3 更稳妥）
• 避免并发下载加剧路由压力：COMPOSER_DISABLE_PARALLEL=1 composer install

调整 PHP 和 cURL 底层超时与 TLS 行为

软路由常因连接空闲超时主动 kill 连接，而 Composer 使用的 cURL 默认 keepalive 时间短、TLS 握手容错弱。需在部署机上针对性调优：

• 增大 cURL 超时：export COMPOSER_HTTP_TIMEOUT=600（默认 300 秒）
• 禁用 TLS 1.3（某些老旧软路由 TLS 栈不兼容）：export COMPOSER_TLS_VERSION=1.2
• 关闭 HTTP/2（部分软路由对 h2 多路复用处理异常）：export COMPOSER_DISABLE_HTTP2=1
• 若用自建镜像源，确保其响应头含 Connection: keep-alive 且服务端未强制 close

部署前预检网络稳定性

别等 composer install 卡住才排查。在 CI/CD 或部署脚本开头加入轻量探测：

curl -sI https://packagist.org/packages.json -o /dev/null -w "%{http_code}\n" | grep -q "200"

更进一步可模拟 Composer 的实际请求头：

curl -s -H "User-Agent: Composer/2.x" -H "Accept: application/json" https://packagist.org/packages.json | head -c 100

如果这些命令频繁失败或耗时 >10s，说明软路由已成瓶颈，应优先修复网络层（如调大 MTU、关闭路由器“快速转发”、换用硬路由或直连）——任何 Composer 层面的 workaround 都只是延缓失败，不是根治。

真正麻烦的从来不是 Composer 参数怎么写，而是你没法让一台刷了 OpenWrt 的小米路由器告诉你它刚刚 silently drop 了第 37 个 FIN 包。