应先定位卡点:DNS解析失败需换DNS或清理hosts,Downloading阶段才调http.timeout(推荐600秒)并切换阿里云镜像源,Executing命令超时则调process-timeout,且须同步调高PHP的default_socket_timeout。

直接换国内镜像源 + 调对超时参数,90% 的 curl error 28、The process timed out 或卡在 Downloading 都能立刻缓解。关键不是“加 timeout”,而是先定位卡在哪一层——DNS、HTTP 还是子进程。
卡在 Resolving dependencies 是 DNS 问题,不是 timeout 能解决的
这一步 Composer 只做域名解析(比如查 mirrors.aliyun.com 的 IP),不发 HTTP 请求,http.timeout 完全无效。
- 用
dig mirrors.aliyun.com @114.114.114.114测试 DNS 是否返回有效 IPv4 地址;若超时或无响应,说明本地 DNS 被污染或不可用 - 临时换 DNS:Linux/macOS 编辑
/etc/resolv.conf加nameserver 8.8.8.8;Windows 在网络适配器里手动设置 - 检查
/etc/hosts(或C:\Windows\System32\drivers\etc\hosts)是否误把mirrors.aliyun.com指向了127.0.0.1或错误 IP - 用手机热点试一次——很多企业网会屏蔽
packagist.org和 GitHub 域名,但热点通常直连通畅
卡在 Downloading 才该调 http.timeout 和镜像源
只有到这一步,Composer 才真正发起 HTTP 请求,此时 http.timeout 和 http.proxy 才起作用。
- 全局延长单次 HTTP 超时:
composer config -g http.timeout 600(单位秒,600 = 10 分钟) - 项目级更稳妥(尤其 CI):在
composer.json的"config"段加"http.timeout": 600 - 必须用国内镜像源,推荐阿里云:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(注意末尾斜杠不能少) - 验证是否生效:
composer config -g repo.packagist输出必须是完整 JSON,如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 换源后必须执行
composer clear-cache,否则旧缓存仍会复用失败地址
卡在 Executing command 或 install/update 整体超时,得调 process-timeout
这步涉及 git clone、unzip、post-install-cmd 等子进程,由 process-timeout 控制,默认仅 300 秒,和 HTTP 请求无关。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 临时绕过(开发/CI):
composer install --process-timeout=0(禁用)或--process-timeout=1200(20 分钟) - 永久生效(全局):
composer config -g process-timeout 1200 - 若已设为 0 仍失败,大概率是内存不足——检查 PHP
memory_limit是否 ≥ 1.5G,尤其update解析锁文件阶段 - 禁用 packagist.org 回源可防 fallback 拖慢:
composer config -g repo.packagist false
代理配置错一个字段就等于没配
只配 http-proxy 一定失败,因为 Packagist、GitHub 全走 HTTPS,必须同时配 https-proxy,且值协议头必须是 http://。
-
https-proxy的正确写法:http://127.0.0.1:7890(Clash/Proxyman)、http://user:pa%40ss%2Fword@127.0.0.1:8080(密码含特殊字符需 URL 编码) - 验证配置:
composer config -g --list | grep -E "(http|https)-proxy",确认两行都存在且格式合规 - NTLM 代理(如公司 Windows 域环境):Composer 原生不支持,必须用
cntlm或px中转,再把两个 proxy 都指向中转地址 - 代理配好了还超时?别只盯着 proxy 字段:
php -i | grep default_socket_timeout若低于你设的http.timeout(常见值是 60),会提前掐断连接
最易被忽略的是:CI 容器重启后 composer config -g 配置丢失,且 process-timeout 和 http.timeout 作用域不同,混用参数不会叠加生效——必须按卡点分层处理,而不是堆 timeout 数值。










