卡在Downloading时应改http-basic-timeout(Composer 2.2+)或http.timeout(旧版),二者均控制单次HTTP请求全周期,默认值过低,建议设为300~600秒,并同步调高PHP的default_socket_timeout。

卡在Downloading时该改http-basic-timeout还是http.timeout
看 Composer 版本:2.2+ 用 http-basic-timeout,旧版用 http.timeout。它控制单次 HTTP 请求的完整生命周期——DNS 解析、TLS 握手、首字节等待、整个 body 传输,不是“下载慢”,而是连接阶段就卡死。默认值太激进(60 或 300 秒),国内常见首字节延迟高,建议设为 300~600。
临时生效:composer install --http-basic-timeout=300(2.2+)或 composer install --timeout=600(旧版);
永久生效:composer config -g http-basic-timeout 300 或 composer config -g http.timeout 600;
⚠️ 注意:php -i | grep default_socket_timeout 查出的 PHP CLI default_socket_timeout 若低于你设的值(如仍是 60),会提前掐断连接,必须同步调高。
The process timed out 错误必须调 process-timeout
这个错误一定出现在子进程执行环节,比如 git clone、unzip、post-install-cmd 脚本卡住,和 HTTP 下载完全无关。错误信息里会明确带 [RuntimeException] The process "" exceeded the timeout,加 -vvv 可看到最后执行的命令。
process-timeout 默认仅 300 秒,且不能通过 composer.json 的 config.timeout 覆盖;
临时禁用(慎用):composer install --process-timeout=0;
稳妥延长:composer install --process-timeout=1200(20 分钟);
永久设置:composer config -g process-timeout 1200;
若已设为 0 仍失败,大概率是内存不足——检查 PHP memory_limit 是否 ≥ 1.5G,尤其 update 解析锁文件阶段。
换镜像源比加 timeout 更治本
80% 的“超时”本质是源不稳定,不是网速慢。阿里云镜像能绕过 DNS 污染、TLS 握手抖动和国外源响应延迟。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
配置命令:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(注意末尾斜杠不能少);
配完必须清缓存:composer clear-cache,否则旧缓存仍会复用失败地址;
验证是否生效:composer config -g repo.packagist 输出应为完整 JSON,且 composer install --dry-run 中下载链接要变成 mirrors.aliyun.com;
⚠️ 注意:"type": "git" 的包会绕过镜像直连 GitHub,此时必须靠 process-timeout 和 Git 自身超时配合,比如 git config --global core.sshCommand "timeout 300 ssh"(Linux/macOS)。
中断后重试前必须精准清理残留
Composer 没有断点续传。中断后残留的破损 ZIP、截断的 installed.json 或卡死的临时目录会持续干扰后续执行。
不要直接删整个 vendor/——这会导致 autoload.php 缺失,引发后续命令报错;
精准清理:rm vendor/autoload.php + rm -rf vendor/composer/;
再运行:composer dump-autoload → composer install;
若仍报 Failed to extract 或 Content-Length mismatch,说明缓存已坏,必须 composer clear-cache。
真正麻烦的从来不是“等多久”,而是中断后 vendor/ 里那些看似完整、实则校验失败的包文件——它们不会自己消失,也不会被自动跳过。










