卡在Resolving dependencies说明DNS解析失败,需用dig验证域名解析、检查nsswitch.conf顺序、排除Docker或企业DNS干扰,并强制IPv4测试;curl -I可进一步暴露TLS或URL路径问题。

卡在Resolving dependencies说明DNS没真正通
这一步 Composer 只做域名解析,不发 HTTP 请求、不读代理、不认 http.timeout。哪怕你改了 /etc/resolv.conf 或设置了 8.8.8.8,也可能被系统层覆盖或缓存干扰。
- 运行
dig mirrors.aliyun.com @8.8.8.8 +short,必须看到 IPv4 地址(如123.56.123.45),若返回空或超时,说明 DNS 查询仍未成功 - 检查
/etc/nsswitch.conf(Linux/macOS)是否含hosts: files dns,若写成hosts: dns files,会跳过/etc/hosts但忽略 DNS 配置 - Docker 容器内默认用 host 网络 DNS,但若用了
--dns或docker-compose.yml中配了dns:,会覆盖宿主机设置——需进容器执行cat /etc/resolv.conf确认 - 某些企业网络强制走本地 DNS 转发器(如 dnsmasq),它可能缓存了错误的 AAAA 记录,导致 IPv6 fallback 卡住:加
-4强制 IPv4 测试,dig -4 mirrors.aliyun.com
curl -I 测试比 Composer 日志更早暴露 TLS 或路径问题
即使 DNS 解析成功,Resolving dependencies 后仍卡住,大概率是 TLS 握手失败或镜像 URL 路径非法——Composer 不报具体错误,但 curl 会明确告诉你。
- 执行
curl -I https://mirrors.aliyun.com/composer/,若返回SSL connect error,说明 OpenSSL 版本太旧或系统 CA 证书缺失;可临时加--insecure验证是否纯 TLS 问题 - 若返回
301 Moved Permanently且 Location 是http://开头,说明镜像站强制跳转到 HTTP,而 Composer 2.x 默认禁用非 HTTPS 源——必须确认 URL 是 HTTPS 且末尾带/ - 若返回
404 Not Found,常见于清华源少斜杠:https://mirrors.tuna.tsinghua.edu.cn/composer❌,正确是https://mirrors.tuna.tsinghua.edu.cn/composer/✅ - 用
curl -v https://mirrors.aliyun.com/composer/ 2>&1 | grep "Connected to"看连接目标 IP 和协议版本,若连的是 IPv6 地址且后续卡住,大概率是 IPv6 路由不通
镜像配置被项目级 repositories 覆盖却无提示
全局配置 repo.packagist 很容易被项目根目录 composer.json 中的 repositories 数组静默覆盖——Composer 不警告,但完全不走你设的镜像。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 运行
composer config repo.packagist(不加-g),输出为空或不是预期 JSON,说明项目级配置生效了 - 检查
composer.json是否有类似这段:"repositories": [ { "packagist.org": false, "type": "composer", "url": "https://packagist.org" } ]这种写法显式关掉 packagist 并指向原始地址,会彻底绕过你的镜像 - 想临时禁用项目级仓库只试镜像效果?加
--no-plugins --no-scripts并删掉repositories段再测 - 验证镜像是否真在用:加
-vvv运行composer update -vvv,看日志里实际请求的 URL 是不是你配的镜像地址
IPv6 fallback 导致“假性卡顿”,不报错却耗时数分钟
这是最隐蔽的超时原因:Composer 默认先尝试 IPv6 地址,单次超时约 2–3 秒,上百个包叠加就是几分钟无响应——日志停在 Loading composer repositories,但 curl -v 显示已连上 IPv6 地址后卡住。
- 快速验证:运行
curl -v https://packagist.org 2>&1 | grep "Connected to",若看到类似Connected to packagist.org (2a03:2880:...)且后续无响应,基本锁定 - 强制禁用 IPv6:Linux/macOS 下临时加环境变量
export CURL_SSL_BACKEND=openssl并运行curl -4 -I https://mirrors.aliyun.com/composer/;Docker 中可在docker run加--sysctl net.ipv6.conf.all.disable_ipv6=1 - PHP 层面也需同步处理:检查
php -i | grep ipv6,若启用了 IPv6 支持但网络不支持,建议编译 PHP 时加--disable-ipv6(CI 环境尤其重要) - 别依赖
composer clear-cache解决这个——缓存清得再干净,每次解析仍会先试 IPv6
真正卡住时,往往不是参数没调够,而是某一层(DNS / TLS / IPv6 / 项目配置)根本没被看见。尤其在 CI 或 Docker 环境中,/etc/resolv.conf、curl 行为、PHP 编译选项三者稍有不一致,就足以让所有超时调整失效。










