必须同时调高process-timeout和http-basic-timeout:前者控制git clone、unzip等子进程执行时限(默认300秒),后者控制DNS解析、TLS握手、首字节等待及body传输总时长(Composer 2.2+默认60秒),二者独立生效,缺一不可。

Composer安装依赖频繁超时,不是网络差,而是process-timeout和http-basic-timeout两个参数默认值太小,且常被单独调整——只改一个,大概率还卡住。
为什么composer install卡在Downloading https://…
这是HTTP层传输超时,和process-timeout完全无关。错误里通常带cURL error 28或反复retry后失败。它控制DNS解析、TLS握手、首字节等待、整个body下载的总耗时,默认仅300秒(旧版)或60秒(http-basic-timeout,Composer 2.2+)。弱网、大包(如laravel/framework dist)、镜像响应慢时极易触发。
- 项目级最稳:运行
composer config http.timeout 600(旧版)或composer config http-basic-timeout 300(2.2+),写入当前composer.json的config段,可提交、可复现 - 全局生效:用
composer config -g http-basic-timeout 300,写入~/.composer/config.json - 临时覆盖优先级最高:比如CI调试时,
COMPOSER_HTTP_BASIC_TIMEOUT=600 composer install - 注意:
php -i | grep default_socket_timeout查出的PHP CLIdefault_socket_timeout若低于你设的http-basic-timeout,连接会被PHP提前掐断——常见值是60,务必同步调高
为什么报The process "" exceeded the timeout
这是子进程执行超时,比如git clone、unzip、运行post-install-cmd脚本。错误里一定含[RuntimeException] The process "" exceeded the timeout,加-vvv能看到最后卡在哪条命令上。它和HTTP下载无关,只管单个外部命令最大执行时间,默认300秒。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 临时救急:用
composer install --timeout=1200(注意等号),优先级最高 - 项目级固化:在
composer.json顶层config里加"process-timeout": 1800 - 全局统一:运行
composer config -g process-timeout 1800,适合CI基础镜像预装 - 设为0表示禁用超时,不推荐——一旦磁盘满或网络异常,进程会无限挂起
为什么配了镜像还是走packagist.org?
全局配置静默失效最常见原因:漏写type参数、路径少斜杠、写错位置。例如composer config -g repo.packagist https://mirrors.aliyun.com/composer/缺中间composer类型,命令看似成功,实际没写进配置;或者用sudo执行,结果写进了/root/.composer/config.json,但当前用户读的是$HOME/.composer/config.json。
- 正确写法必须带
composer类型:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL末尾必须有斜杠:
https://mirrors.aliyun.com/composer/✅,https://mirrors.aliyun.com/composer❌ - 验证是否真生效:
composer config -g repo.packagist输出必须是完整JSON:{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 改完必须立刻
composer clear-cache,否则仍读旧缓存,镜像等于白配
真正卡住的时候,往往不是单一参数问题,而是镜像没生效 + http-basic-timeout太短 + 缓存未清三者叠加。先确认composer config -g repo.packagist输出正确URL,再清缓存,最后调参——顺序错了,调再久也没用。

















