必须同时调高process-timeout和http-basic-timeout,并禁用并行下载、切换国内镜像源,缺一不可;单改process-timeout无效,因http-basic-timeout默认仅60秒会提前中断HTTP下载。

直接结论:只调 process-timeout 是最常见也最无效的“半吊子配置”——必须同时控制 http-basic-timeout、禁用并行下载、换镜像源,三者缺一不可。
为什么单改 process-timeout 还是会超时?
因为 Composer 有两层超时机制:外层 process-timeout 控整个命令生命周期(解析 + 下载 + 解压 + 脚本),内层 http-basic-timeout 控每个 HTTP 请求(比如拉一个 zip 包)。默认值分别是 300 秒和 60 秒。你把外层提到 1800,但某个包下载卡在第 61 秒,http-basic-timeout 就直接中断了,根本等不到外层生效。
-
http-basic-timeout从 Composer 2.2 开始支持;旧版本只能靠换源或降并发硬扛 - 即使设为 0(无限制),curl 底层仍受 PHP 的
default_socket_timeout影响(通常 60 秒) - 某些私有 Git 仓库走的是 SSH 或 HTTPS clone,不走 HTTP 下载逻辑,
http-basic-timeout对它完全无效
高手实际用的稳定组合配置
不是“设个大数”,而是分场景收敛风险点:
- 全局永久生效(推荐 CI/CD 和开发机统一):
composer config -g process-timeout 1800composer config -g http-basic-timeout 300composer config -g use-include-path false(禁用并行下载,降低连接压力) - 临时绕过(调试或单次部署):
COMPOSER_PROCESS_TIMEOUT=0 COMPOSER_HTTP_BASIC_TIMEOUT=0 composer install --no-interaction - 项目级覆盖(如团队要求严格 timeout):
在项目composer.json的config段里写:"process-timeout": 1200,"http-basic-timeout": 240,"use-include-path": false
国内环境必须同步做的三件事
光调超时只是“保命”,不是“提速”。很多失败根本不是超时,而是请求发错了地方:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 全局换源:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,并确认没在项目composer.json里硬编码"packagist.org"或冗余repositories - 禁用回源:
composer config -g repos.packagist false(防止镜像未命中时 fallback 到官方源,那才是真慢) - 强制 IPv4:
export COMPOSER_IPRESOLVE=4(WSL2 / Docker Desktop 常因 IPv6 DNS 解析卡住,不报错但死等)
容易被忽略的“伪超时”陷阱
很多报 The process timed out 的情况,其实跟网络无关:
- 卡在
Generating autoload files阶段?大概率是vendor/下有 symlink 或嵌套过深的包,I/O 阻塞;可加--no-autoloader分离验证 - 卡在
post-install-cmd?检查脚本里有没有php artisan key:generate这类需要交互的命令,必须加--no-interaction - PHP 自身限制:确保
max_execution_time≥process-timeout,memory_limit不低于 512M(尤其 Laravel 全量安装)
真正稳定的配置,从来不是堆数字,而是让每一层都清楚自己该等多久、该连哪里、该跳过什么。










