单纯配两个DNS服务器不够,因Composer不支持自动主备切换,其依赖系统resolver按序尝试,超时才切下一个;且IPv6 fallback、镜像源未生效、CI环境配置缺失等均会导致失效。

为什么单纯配两个DNS服务器还不够
很多人以为在 composer.json 或系统里写上两个 DNS 地址(比如 8.8.8.8 和 114.114.114.114)就能自动“主备切换”或“就近选择”,其实不是。Composer 本身不解析域名——它依赖 PHP 的 cURL 或 stream 扩展,而这些底层能力又完全交给操作系统 resolver(如 /etc/resolv.conf)或 libc。Linux 默认按顺序尝试,第一个超时(通常 5 秒)才切第二个,叠加上百个包的元数据请求,就是几分钟卡在 Resolving dependencies。
真正起效的双DNS配置位置有三个
必须分层处理,不能只改一处:
- 宿主机层面:修改
/etc/resolv.conf,把内网 DNS(如192.168.10.5)放第一行,公网 DNS(如8.8.8.8)放第二行;记得加options timeout:2 attempts:2防止单次等待过长 - Docker 容器内:用
docker run --dns 192.168.10.5 --dns 8.8.8.8启动,或在docker-compose.yml的 service 下显式写dns字段(host模式下该字段无效) - PHP 运行时(极少数场景):如果用
php -d dns=启动 Composer,这个参数并不存在——PHP 不提供运行时 DNS 设置,别白费劲
IPv6 fallback 是隐藏杀手,必须关掉
默认情况下,glibc 会先尝试 IPv6 地址(比如 2a03:2880:...),等 1–3 秒无响应再退到 IPv4。你看到的“卡住但没报错”,大概率是它在等 IPv6 超时。验证方法:curl -v https://packagist.org 2>&1 | grep "Connected to"。如果看到 IPv6 地址且后续停顿,就对了。
解决方式只有两个:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 全局禁用 IPv6 DNS 查询:在
/etc/gai.conf末尾加一行precedence ::ffff:0:0/96 100(优先 IPv4) - 或更直接:在宿主机和容器里都执行
sysctl -w net.ipv6.conf.all.disable_ipv6=1(临时),或写入/etc/sysctl.conf永久生效
镜像源 + 双DNS 必须配合验证才可靠
配完 DNS 不代表 Composer 就快了——它可能根本没走你设的地址。关键验证步骤:
- 执行
composer config -g repo.packagist,输出必须是完整 JSON,形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"};空值或仍是https://packagist.org说明镜像没生效 - 跑一次
composer install -vvv 2>&1 | grep "Downloading",确认所有下载 URL 都来自镜像域名(如mirrors.aliyun.com),而不是packagist.org或github.com - 如果仍出现
Failed to decode response: file_get_contents(): SSL operation failed,不是 DNS 问题,是 TLS 层被拦截,换手机热点一试便知
最常被忽略的是:CI 环境(如 GitHub Actions)里,你本地配的 ~/.composer/config.json 完全不可见,必须在 CI 脚本开头重新执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 并清缓存。










