如何配置Composer实现断点续装以应对网络不稳定问题？

本文共计820个文字，预计阅读时间需要4分钟。

Composer 本身不支持断点续传，所谓的续装实际上是依赖于缓存、目录状态和锁文件对比来跳过已成功部分——它并非下载器，而是依赖依赖解析和安装的组合流程。

网络中断后，需进行硬等重试，反复校验、重试、解压，反而会更慢。

composer install 中断后怎么继续？

别指望自动续传，得手动清理+策略重试：

• 删掉 vendor/ 目录（或只删失败包的子目录，如 vendor/monolog/monolog）
• 删掉 vendor/composer/installed.json（若 vendor/ 已清空，这步自动生效）
• 运行 composer clear-cache，避免复用损坏的 zip 缓存
• 加 --no-scripts --no-plugins 重试：跳过脚本执行和插件逻辑，降低失败面
• 确保 composer.lock 完整未被修改，否则会触发全量重新解析

为什么换镜像源比调重试参数更有效？

下载中断八成不是因为网速慢，而是连不上 packagist.org —— DNS 解析卡顿、TLS 握手失败、中间设备切断长连接，这些在阿里云、腾讯云镜像上基本不存在。

• 全局配阿里镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 确认生效：composer config -g repo.packagist 应输出镜像 URL
• 私有包没同步到镜像？需单独配置 repositories，否则会回退到官方源卡住
• 镜像站返回 503 或超时？用 curl -I https://mirrors.aliyun.com/composer/ 验证连通性

怎么让 Composer 在低带宽下“稳住不崩”？

核心是减少单次失败代价 + 避免非必要网络交互：

• 强制走 dist 包：composer install --prefer-dist --no-plugins（--prefer-dist 比 git clone 小得多，校验快、失败率低）
• 延长超时：composer config -g http.timeout 600 + composer config -g process-timeout 600
• 启用并行下载（Composer 2.2+）：composer config -g parallel-downloads 10，但 Docker 构建时建议降到 6，避免临时文件竞争
• 禁用非必要功能：--no-autoloader --no-scripts 可省 30%+ 时间，后续补 composer dump-autoload --optimize

离线环境还能不能装？

能，但必须提前准备，且不能依赖任何网络请求：

• 设置环境变量：COMPOSER_DISABLE_NETWORK=1 + COMPOSER_NO_INTERACTION=1
• 确保已有完整 vendor/ 和匹配的 composer.lock
• 运行命令时加 --ignore-platform-reqs --no-progress --no-suggest
• composer update 在离线状态下必然失败，没有替代方案；所有依赖必须提前固化

真正容易被忽略的是 vendor 目录权限、Windows 长路径、符号链接残留——这些会让“看似续上了”的安装在解压或 autoload 生成阶段静默失败，比重新下载还难排查。