Composer超时配置中真正生效的只有http-timeout(控制单次HTTP请求,含DNS、TLS、首字节及body传输)和process-timeout(控制git clone、unzip等子进程执行),二者缺一不可;其他如http-basic-timeout在v2中被忽略,且timeout参数本身不生效。

Composer 超时配置本身不会导致“超时”,真正起作用的只有 http-timeout 和 process-timeout 两个参数;其他如 http-basic-timeout 在 Composer v2 中完全被忽略,设了也白设。
为什么改了 timeout 还是报 cURL error 28
因为 cURL error 28 只在 HTTP 下载阶段触发,而你可能卡在更早的阶段——比如 Resolving dependencies。这个阶段只做 DNS 解析和读取 packages.json 元数据,根本没发 HTTP 请求,http-timeout 完全不生效。
- 先运行
dig mirrors.aliyun.com或nslookup packagist.org,看是否能返回 IPv4 地址;若超时,说明是本地 DNS 问题,不是 timeout 配置低 - 如果
composer config -g http-timeout输出为空或报错,说明配置根本没写进去,别信自己“记得敲过” -
http-timeout控制的是单次请求(含 DNS + TLS 握手 + 首字节等待 + body 传输),默认仅 60 秒;国内镜像首字节延迟高时,60 秒极易不够用 - 验证是否真生效:加
-vvv运行composer install,看到日志里出现Downloading https://...后卡住,才是http-timeout没调够
process-timeout 和 http-timeout 的分工差异
process-timeout 管的是整个命令生命周期(比如 composer update 从开始到结束),而 http-timeout 只管单次 HTTP 请求。两者不能互相替代,但容易混淆。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
process-timeout默认 300 秒,适用于拉取大包、解压 ZIP、执行 post-install-cmd 脚本等耗时操作;卡在Extracting archive或Running post-update-cmd时才该调它 -
http-timeout默认 60 秒,只影响Downloading行为;卡在Downloading https://mirrors.aliyun.com/composer/packages.json就得动它 - CI 环境建议项目级配置:
"config": {"http-timeout": 600, "process-timeout": 0},避免全局配置被容器覆盖 - 别设
process-timeout 0在本地开发机——它会禁用所有超时保护,遇到死循环或挂起的 Git 进程就只能Ctrl+C
镜像配置错误导致 timeout 配置静默失效
换源命令漏一个字符、少一个斜杠、键名写错,都会让镜像配置完全不生效,但 Composer 不报错。此时你调再大的 http-timeout,实际连的还是慢如蜗牛的 packagist.org。
- 必须严格检查键名:
repo.packagist(不是repos.packagist,也不是repository.packagist) -
type值必须是composer,不能拼成compose或省略 - URL 必须以
/结尾:https://mirrors.aliyun.com/composer/✅,https://mirrors.aliyun.com/composer❌(少斜杠会导致拼出非法路径/composerpackages.json) - 验证是否真生效:
composer config -g repo.packagist输出必须是完整 JSON,例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 换源后必须执行
composer clear-cache,否则旧缓存仍会复用失败路径
最常被忽略的一点:超时参数只在“网络请求真正发生”时才起作用。DNS 解析失败、镜像 URL 拼错、composer.lock 里硬编码了已下线 provider 地址——这些情况下,调大 timeout 只会让失败来得更慢,而不是解决问题。

















