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

直接调高 process-timeout,不是 http.timeout —— 这是绝大多数人第一步就踩错的地方。
卡在 Downloading https:// 时该调哪个参数
看到 Downloading https:// 卡住,错误里带 cURL error 28 或反复 retry,说明是 HTTP 请求层超时。这时候真正起作用的是 http.timeout(Composer 2.x),它控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总时间,默认仅 300 秒。
- 项目级最稳:运行
composer config http.timeout 600,写入当前composer.json的config段,可提交、可复现 - 全局生效:用
composer config -g http.timeout 600,写入~/.composer/config.json - 临时覆盖优先级最高:设环境变量
COMPOSER_HTTP_TIMEOUT=1200再跑命令,适合 CI 调试 - 注意:
php -i | grep default_socket_timeout查出的 PHP CLIdefault_socket_timeout若低于你设的http.timeout,会提前掐断连接——常见值是 60,务必同步调高
The process timed out 错误该调哪一项
错误信息明确含 The process "" exceeded the timeout,且 -vvv 输出最后一行是 Executing command(比如 git clone、unzip、post-install-cmd),这就是 process-timeout 在起作用。它和 HTTP 完全无关,只管子进程执行总耗时,默认 300 秒。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- 全局改:运行
composer config -g process-timeout 1800(30 分钟) - 项目级改:在
composer.json顶层加"config": {"process-timeout": 1200} - CI 环境建议用环境变量兜底:
COMPOSER_PROCESS_TIMEOUT=2000,某些 Composer 版本对它更敏感 - 设为 0 表示不限时,但不推荐——万一远程 Git 仓库彻底不可达,会无限挂起
为什么换镜像比配代理更可靠
Composer 默认走 HTTPS,多数本地或公司 HTTP 代理不支持 CONNECT 隧道,导致卡在 Downloading https://。而镜像源(如阿里云 https://mirrors.aliyun.com/composer/)本身是 HTTPS 可直连的,不依赖代理隧道。
- 设阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效:
composer config -g repo.packagist应输出对应 URL - 注意:换源后仍可能超时——因为某些包(尤其
"type": "git")会绕过镜像直连 GitHub,此时必须配合process-timeout和 Git 层配置 - Git 包下载失败时,
git clone超时才是真瓶颈;可强制 Git 走 HTTPS:composer config -g github-protocols https
真正容易被忽略的是:两个 timeout 参数必须配合使用,且要同步检查 PHP 底层 socket 限制。单独调高一个,大概率还是卡住。

















