必须先看-vvv最后一行:停在Resolving dependencies是DNS问题,停在Downloading才调http.timeout,停在Executing command才调process-timeout,两者作用域不同,不可混用。

网络超时不是“连不上”,而是参数没对准卡点位置——必须先看-vvv最后一行停在哪,再动对应配置。
怎么一眼看出卡在 DNS、HTTP 还是子进程
运行composer install -vvv或composer update -vvv,盯住终端最后一行输出:
- 停在
Resolving dependencies:纯 DNS 问题,跟http.timeout和process-timeout完全无关;用dig packagist.org @114.114.114.114验证解析是否通 - 停在
Downloading https://...:HTTP 层超时,该调http.timeout(默认仅 60 秒),不是process-timeout - 停在
Executing command (CWD: ...):子进程(如git clone、unzip)卡死,此时process-timeout才生效 - 停在
Generating autoload files后没反应:不是网络问题,是 PHP 内存不足、APCu 未启用 CLI 模式,或 WSL2 symlink 导致 I/O 阻塞
http.timeout 和 process-timeout 到底改哪个
这两个参数互不重叠,混着调等于乱按开关:
-
http.timeout:控制单次 HTTP 请求(含 DNS 查询、TLS 握手、首字节等待、body 下载),默认 60 秒。下载大包或镜像首字节延迟高时最先触发失败。建议设为600 -
process-timeout:控制整个命令从 start 到 end 的总耗时上限(含解压、执行post-install-cmd、生成 autoloader),默认 300 秒。大型项目跑脚本容易超,推荐设为1200 -
http-basic.timeout是 Composer v1 废弃项,v2 完全不读取,写了也无效
代理配了还是超时?大概率漏了 https-proxy
只配http-proxy一定失败——因为 Packagist、GitHub、GitLab 全走 HTTPS,而 Composer 对协议严格分离路由:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
https-proxy的值必须以http://开头,哪怕你的代理监听的是 HTTPS 端口,例如:http://127.0.0.1:7890 - 密码含
@或/必须 URL 编码,如pa@ss/word→pa%40ss%2Fword - 验证是否生效:
composer config -g --list | grep -E "(http|https)-proxy",应同时输出两行且格式合规 - NTLM 代理(如公司 Windows 域)需用
cntlm或px中转,再让 Composer 指向中转地址
CI/CD 中 timeout 配置常被忽略的硬伤
容器重启后全局配置丢失,光加--timeout参数根本不管用:
- 必须显式设置环境变量:
COMPOSER_PROCESS_TIMEOUT=1200和COMPOSER_HOME=/tmp/composer - 强制用 dist 包:
--prefer-dist,避免git clone卡住 - 禁用并行下载:
composer config -g use-include-path false,降低连接压力 - 检查是否硬编码了
git@github.com:这类 SSH 地址;换成 HTTPS 或配GIT_SSH_COMMAND - Docker 容器若被
--stop-timeout或外层timeout命令包裹,Composer 根本感知不到,那是另一层中断
最常被忽略的其实是 PHP 自身的default_socket_timeout——它若低于你设的http.timeout(常见值是 60),连接会在 Composer 层之前就被掐断。查它:php -i | grep default_socket_timeout。










