应修改 process-timeout 字段,其控制 git clone 等子进程超时,默认 300 秒;须为整数、不可加引号;项目级配 composer.json config 节点,全局用 composer config -g,临时用 --process-timeout= 或 COMPOSER_PROCESS_TIMEOUT。

直接改 process-timeout,不是 timeout、http.timeout 或 PHP 的 max_execution_time —— 错配字段或参数名,Composer 会静默忽略,根本不起作用。
报 “The process "" exceeded the timeout” 就该调 process-timeout
这个错误明确指向子进程执行超时:比如 git clone 私有仓库、unzip 几百 MB 的 dist 包、运行 post-install-cmd 脚本等。它和网络下载无关,http.timeout 再大也救不了。
-
process-timeout控制单个外部命令最大运行秒数,默认仅300(5 分钟),弱网或含大量 Git 包的项目极易触发 - 值必须是整数,不能加引号:
"process-timeout": 1200✅,"process-timeout": "1200"❌ - 设为
0表示禁用超时,但 CI 中不推荐——镜像不可达时会无限挂起,无法自动退出 - 旧版 Composer(如 1.x)中,该值同时影响
git和curl;2.x 后仍管git clone,但 HTTPS 下载已移交http.timeout管理
项目级配置:写进 composer.json 最稳
在项目根目录的 composer.json 顶层 config 节点下添加,随代码提交,CI/CD 自动继承:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
{
"config": {
"process-timeout": 1200
}
}
- 执行
composer dump-autoload -o不影响超时,但建议顺手跑一次,避免 autoload 错误掩盖真实超时问题 - 别写
"timeout": 1200—— 这字段早被废弃,Composer 完全不识别 - 修改后无需重启终端或重装 Composer,下次
composer install就生效
全局配置:适合本地开发或 CI 镜像预置
运行以下命令,把值写入用户级配置文件(路径因系统而异,可用 composer config -g --list 确认):
composer config -g process-timeout 1800
- 全局配置优先级低于命令行参数,但高于项目级
composer.json中同名项 - CI runner 镜像中预置此命令,比每个项目都改
composer.json更省事 - 验证是否生效:
composer config -g process-timeout,输出1800即成功;无输出说明仍用默认300 - 注意别混淆:
composer config process-timeout 1200(不带-g)是改当前项目composer.json,不是全局
临时覆盖:命令行和环境变量优先级最高
调试阶段最灵活的方式,且能穿透所有配置层级:
- 命令行参数:
composer install --process-timeout=1800(必须带等号,--process-timeout 1800会被静默忽略) - 环境变量:
COMPOSER_PROCESS_TIMEOUT=1800 composer install,对所有子命令(包括composer run-script)生效 - 环境变量优先级最高,但一旦设为
0,整个流程就失去熔断保护,得确保外层有timeout命令兜底(如 Docker 的--stop-timeout) - 某些 CI 平台(如 GitHub Actions)需显式声明
COMPOSER_HOME,否则容器重启后环境变量丢失
真正容易被忽略的是:即使 process-timeout 设到 30 分钟,如果卡在 Downloading https://... 阶段,那问题根本不在这里——你得同步调高 http.timeout,并确认 PHP 的 default_socket_timeout 没把它提前掐断。

















