卡在“Loading composer repositories”或“Resolving packages”时,首要解决DNS解析或TLS握手问题,而非盲目调大timeout;应优先配置http.timeout、github-protocols、禁用IPv6 fallback并验证DNS。

composer install 卡住时 timeout 不是首要参数
Composer 默认的 timeout(默认 300 秒)只控制单个 HTTP 请求,而卡在 “Loading composer repositories” 或 “Resolving packages” 阶段,90% 是 DNS 解析失败或 TLS 握手超时,不是请求本身慢。盲目调大 timeout 只会让错误延迟暴露,不解决根本问题。
真正要改的是 http.timeout 和 github-protocols
Composer 的网络行为由多个底层配置共同控制,http.timeout 才影响整体连接等待,github-protocols 决定是否强制走 HTTPS(避免 Git over SSH 在虚拟机中因密钥缺失卡死):
-
composer config -g http.timeout 600—— 把全局 HTTP 连接+读取总时限拉到 10 分钟 -
composer config -g github-protocols https—— 强制 GitHub 相关操作走 HTTPS,绕过 SSH 密钥验证失败 - 若仍卡在 git clone,可加
git.clone-depth=1减少历史拉取量:composer config -g git.clone-depth 1
vagrant 虚拟机里必须同步禁用 IPv6 fallback
VirtualBox/Vagrant 默认启用 IPv6,但多数国内镜像站不支持 IPv6 地址,Composer 会先等 2–3 秒 IPv6 超时再切 IPv4,100 个包就拖 5 分钟——日志里却无报错。必须在虚拟机内执行:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
echo 'precedence ::ffff:0:0/96 100' | sudo tee -a /etc/gai.conf
这行配置让系统优先使用 IPv4,比改 timeout 实效高得多。别漏掉验证:getent ahosts packagist.org 应只返回 IPv4 地址。
CI 或自动化脚本中应显式传参而非依赖全局配置
在 Vagrant provision、Ansible 或 CI 流水线里,用 composer install 命令时,直接带参数比依赖 config -g 更可靠(避免环境变量污染或权限隔离导致配置未生效):
composer install --no-interaction --no-dev --optimize-autoloader --timeout=600- 注意:
--timeout是 CLI 参数,只对当前命令生效;http.timeout是配置项,影响所有后续操作 - 如果用了
COMPOSER_CACHE_DIR或挂载了共享目录,务必确认缓存路径不在 vboxsf 上,否则 I/O 延迟会让 timeout 失效
最常被忽略的一点:timeout 参数不会阻止 DNS 卡死。哪怕设成 3600,只要 /etc/resolv.conf 指向一个无法响应的 DNS,它就永远停在 “Resolving packages…” —— 先跑 nslookup packagist.org,再谈 timeout。

















