卡在Downloading https://时应调http.timeout参数,它控制DNS解析、TLS握手、首字节等待及整个body传输总时间,默认300秒,弱网下易超时,需同步调高PHP的default_socket_timeout。

卡在 Downloading https:// 就是 HTTP 请求阶段卡住,不是命令写错了,也不是包本身有问题,而是 Composer 默认的超时阈值太短,加上国内网络环境不稳定,直接触发中断。
为什么改 config.timeout 没用
这是最常踩的坑:config.timeout 只控制单次连接或读取的底层 socket 超时,不控制整个下载流程。真正决定“卡死还是继续”的是 http.timeout(Composer 2.x)或 http-basic-timeout(2.2+),它管的是 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总时间。
默认仅 300 秒(5 分钟),弱网下拉一个大 ZIP 包(比如 laravel/framework 的 dist)很容易超时。
- 项目级生效:运行
composer config http.timeout 600,写入当前composer.json的config段 - 全局生效:运行
composer config -g http.timeout 600,写入~/.composer/config.json - 临时覆盖(CI 最推荐):
COMPOSER_HTTP_TIMEOUT=1200 composer install
注意:php -i | grep default_socket_timeout 查出的 PHP CLI default_socket_timeout 若低于你设的 http.timeout,会提前掐断连接——常见值是 60,务必同步调高。
The process timed out 错误该调哪个参数
这个错误一定含 [RuntimeException] The process "" exceeded the timeout,加 -vvv 能看到最后执行的那条命令,比如 git clone 或 unzip。它和 HTTP 下载无关,是子进程执行太久被杀。
process-timeout 控制单个外部命令最大执行时间,默认 300 秒,必须调高:
- 全局改:
composer config -g process-timeout 1800 - 项目级改:在
composer.json顶层加"config": {"process-timeout": 1200} - CI 环境兜底:
COMPOSER_PROCESS_TIMEOUT=2000,某些 Composer 版本对它更敏感
设为 0 表示不限时,但不推荐——万一远程 Git 仓库彻底不可达,会无限挂起。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
换镜像比配代理更可靠
Composer 默认走 HTTPS,多数本地或公司 HTTP 代理不支持 CONNECT 隧道,导致卡在 Downloading https://。换源才是治本之策。
主流可用镜像只剩两个:
- 阿里云:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 中科大:
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/
验证是否生效:composer config -g repo.packagist 应输出对应 URL。
注意:换源后仍可能超时——因为某些包(尤其 "type": "git")会绕过镜像直连 GitHub,此时必须配合 process-timeout 和 Git 代理。
Git 克隆卡住要单独处理
遇到 "type": "git" 的包(比如开发版依赖),Composer 会调系统 git clone,而该命令默认无超时限制,但若卡在 DNS 或握手阶段,就会无限等待。
这时 process-timeout 才真正起作用。额外加固建议:
- 强制 Git 走 HTTPS:
composer config -g github-protocols https - 给 Git 加超时(Linux/macOS):
git config --global core.sshCommand "timeout 300 ssh" - 私有包改用 HTTPS 地址:
"https://github.com/user/repo.git"替代"git@github.com:user/repo.git"
真正容易被忽略的是 PHP 的 default_socket_timeout 和 Git 的底层超时——它们不归 Composer 直接管,但会无声截断请求。调高 http.timeout 和 process-timeout 后,务必确认这两层没拖后腿。

















