最可靠方式是运行composer install -vvv | grep timeout查看实际请求日志中的timeout值,而非仅依赖composer config输出;需同时检查PHP的default_socket_timeout是否匹配,且确认http.timeout与process-timeout分别控制HTTP请求和命令全过程超时。

怎么确认当前生效的 timeout 配置值
别只信 composer config 的输出,它可能读的是错误层级(比如项目级命令却查了全局配置),或字段拼写/格式有误导致被静默忽略。最可靠的方式是加 -vvv 看实际请求日志里用的值。
运行:composer install -vvv 2>&1 | grep -E "(timeout|CURLOPT_TIMEOUT|process-timeout)"
你会看到类似这样的行:Downloading https://mirrors.aliyun.com/composer/p2/laravel/framework.json (curl) with timeout 600Running command (CWD): git clone --no-checkout 'https://github.com/laravel/framework.git' ... with timeout 1200
这些才是真实起作用的数值。如果没看到对应 timeout 字段,说明配置根本没加载成功。
常见失效原因包括:
-
http.timeout写成http_timeout或httpTimeout(必须是连字符) - 值用了字符串:
"http.timeout": "600"❌ → 必须是整数:"http.timeout": 600✅ - 改的是项目级
composer.json,但你在项目外执行了composer install(此时读的是全局配置)
process-timeout 和 http.timeout 到底谁管什么
这两个参数不重叠,也不互相替代,各自控制完全不同的环节:
-
process-timeout:控制整个 Composer 命令生命周期,比如composer update从解析依赖、下载 ZIP、解压、执行脚本到生成 autoload,全程不能超这个秒数。卡在Cloning into 'vendor/xxx'或Extracting archive就是它在起作用。 -
http.timeout:只管单次 HTTP 请求——DNS + TLS 握手 + 首字节等待 + 整个 body 传输总时长。卡在Downloading https://...且报cURL error 28,就是它被触发了。
注意:http-basic-timeout 是 Composer 2.2+ 新增的独立参数,专管 Basic Auth 场景下的连接/读取时限,和 http.timeout 并存,不互斥。旧版本没有它,只能靠 http.timeout 和 process-timeout 双控。
为什么调大 timeout 还是失败?检查 PHP 底层 socket 超时
Composer 自己设的 http.timeout 再大也没用,如果 PHP 底层的 default_socket_timeout 更小,cURL 会在那个时间点被硬中断,Composer 根本收不到响应。
查当前值:php -i | grep default_socket_timeout
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
默认通常是 60 秒。哪怕你把 http.timeout 设成 1200,只要 PHP 这个值还是 60,就会在第 60 秒断掉,报错仍是 cURL error 28。
临时验证(当前终端有效):php -d default_socket_timeout=600 /usr/bin/composer install
永久修改需编辑对应 PHP CLI 版本的 php.ini(不是 Web 用的那个),搜 default_socket_timeout,改成 600,然后重启 PHP CLI 进程(Linux/macOS 无需 reload Apache/Nginx,但宝塔用户要注意:面板默认用系统 PHP,不是你网站设置的版本)。
重试机制有没有生效?怎么看
Composer 内置了自动重试,但只对部分可恢复错误触发(如连接拒绝、临时 DNS 失败),不是所有超时都重试。而且默认最多 3 次,间隔递增。
看是否启用重试,关键不是配参数,而是观察 -vvv 日志里有没有重复出现同一 URL 的 Downloading 行。例如:
Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json
如果有三行,说明重试已工作;如果只有一行就报错,那可能是不可恢复错误(如 404、TLS 握手失败、认证失败),重试不会发生。
注意:--retry-auth-failure=false 这类参数仅影响认证类失败,对网络超时无效。真正影响重试行为的是底层 cURL 策略,用户无法直接配置次数或间隔。
最容易被忽略的一点:镜像配置错误比 timeout 设置更重要。如果 composer config -g repo.packagist 输出的 URL 缺少末尾 /,或 type 不是 composer,Composer 会静默回退到官方源——这时你调再大的 timeout,也还是在等一个根本连不通的地址。










