必须同时调整 process-timeout 和 http.timeout;前者控制 git clone、unzip 等子进程超时,后者控制 DNS 解析、TLS 握手及 HTTP 全流程,默认均为 300 秒,弱网或大包场景需同步调高至 600+ 秒,并确保 PHP default_socket_timeout 不低于该值。

直接改 process-timeout 和 http.timeout 两个参数,缺一不可;只调一个大概率还是超时。
卡在 Downloading https:// 时该调 http.timeout
这是 HTTP 请求阶段卡住,比如拉 packages.json、下载 ZIP 包,错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout,只认 http.timeout(Composer 2.x)。
-
http.timeout控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输,单位秒,默认仅 300(5 分钟),弱网下极易触发 - 项目级最稳:运行
composer config http.timeout 600,写入当前composer.json的config段,可提交、可复现 - 全局生效:用
composer config -g http.timeout 600,写入~/.composer/config.json - 临时覆盖优先级最高:
COMPOSER_HTTP_TIMEOUT=1200 composer install,适合 CI 调试 - 注意:
php -i | grep default_socket_timeout查出的 PHP CLIdefault_socket_timeout若低于你设的http.timeout,会提前掐断连接——常见值是 60,务必同步调高
报错 “The process timed out” 时该调 process-timeout
这是子进程执行太久被杀,比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout,加 -vvv 可看到最后那条命令。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
-
process-timeout控制单个外部命令最大执行时间,默认 300 秒,和 HTTP 完全无关 - 全局改:运行
composer config -g process-timeout 1800(30 分钟),写入~/.composer/config.json - 项目级改:直接在
composer.json顶层加"config": {"process-timeout": 1200} - CI 环境建议用环境变量兜底:
COMPOSER_PROCESS_TIMEOUT=2000,某些 Composer 版本对它更敏感
别踩这些坑
很多人以为改了 composer.json 里的 config.timeout 就行——其实这个字段在 Composer 2.x 中已被忽略,根本不起作用。还有人把 http-basic-timeout 当成通用参数去设,但它只在 Composer 2.2+ 支持,且优先级低于 http.timeout,旧版本压根不读。
- 调高
http.timeout前,先确认 PHP 的default_socket_timeout不比它小 - 换镜像源(如
https://mirrors.aliyun.com/composer/)比单纯延长时间更治本,但要注意:Git 类包("type": "git")不会走镜像,仍需靠process-timeout和 Git 自身配置兜底 - CI 环境中,环境变量
COMPOSER_PROCESS_TIMEOUT和COMPOSER_HTTP_TIMEOUT的优先级高于 config 文件,但部分低版本 Composer 对后者支持不稳定,建议双保险
真正容易被忽略的是:这两个超时参数控制的是完全不同的阶段,而绝大多数失败都同时涉及 HTTP 下载和后续解压/脚本执行。不一起调,等于只修半边轮胎。

















