DNS解析失败是根因,需优先改系统DNS(如223.5.5.5)、预置hosts映射、再正确配置镜像源(repo.packagist键名+HTTPS+末尾斜杠),三者缺一不可。

Composer 卡在 Loading composer repositories 或报 cURL error 6: Could not resolve host,基本就是 DNS 解析失败,不是网络不通,也不是 Composer 慢——换镜像源+改 DNS+预置 hosts 才是根治手段。
为什么改 DNS 比换镜像源还关键
DNS 解析失败时,哪怕镜像 URL 正确,composer install 也会卡在第一步:连不上域名。国内很多环境(尤其是虚拟机、Docker、企业内网)默认 DNS 不稳定或被劫持,packagist.org、github.com、mirrors.aliyun.com 全都解析超时。
- 优先改系统级 DNS,而不是依赖镜像 CDN 的 GSLB —— Composer 不感知地理位置,只认你解析出来的 IP
- 推荐用
223.5.5.5(阿里云)或114.114.114.114(江苏电信),比8.8.8.8在国内更稳 - Linux/macOS 编辑
/etc/resolv.conf,只留一行:nameserver 223.5.5.5;Windows 改网络适配器的 IPv4 DNS 设置 - 禁用
systemd-resolved(Ubuntu/Debian 常见):运行sudo systemctl disable --now systemd-resolved,否则它会偷偷覆盖resolv.conf
hosts 预置能绕过 90% 的解析失败
有些网络(比如校园网、部分云主机)会拦截 DNS 查询但不拦截直接 IP 访问。此时即使 DNS 正常,curl -I https://mirrors.aliyun.com/composer/ 也可能失败,但填对 IP 就通。
- 先确认当前可用 IP:
dig mirrors.aliyun.com +short或nslookup mirrors.aliyun.com 223.5.5.5 - 编辑
/etc/hosts(Linux/macOS)或C:\Windows\System32\drivers\etc\hosts(Windows),追加(示例 IP,以实际查询为准):223.6.6.6 mirrors.aliyun.com<br>223.6.6.6 packagist.org<br>140.82.114.4 github.com<br>185.199.108.133 githubusercontent.com
- 注意:不要写 HTTPS 端口或路径,只写域名和 IP;每行一个映射;改完清本地 DNS 缓存(
sudo dscacheutil -flushcache或ipconfig /flushdns)
镜像源配置必须用 repo.packagist(不是 repos.packagist)
Composer ≥2.2 只识别 repo.packagist 这个键名,旧教程里写的 repos.packagist 或 packagist.org 会导致配置静默失效,composer config -g repo.packagist 输出为空或仍是 https://packagist.org 就说明没生效。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 正确命令:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否写入:
composer config -g repo.packagist应输出完整 URL;再看~/.composer/config.json里是否有"repo.packagist"字段 - 末尾必须带斜杠
/,漏掉会 404;必须用 HTTPS,HTTP 会被 Composer 2.2+ 拒绝 - 如果公司有私有镜像,确保它支持
allow-plugins: true(Composer ≥2.2 默认禁用未声明插件)
Docker 和虚拟机里要额外防文件系统拖慢
在 VirtualBox/VMware 中挂载宿主机目录后直接跑 composer install,经常卡在 Extracting archive —— 这不是 DNS 或网络问题,是挂载层 I/O 延迟导致解压极慢。
- 开发时,把代码复制进虚拟机本地磁盘(如
/home/vagrant/myapp),再执行 Composer - Docker 中避免
-v $(pwd):/app后直接composer install;改用命名卷缓存 vendor:docker run -v $(pwd):/app -v myapp-vendor:/app/vendor php:8.3-cli composer install - 容器启动时加
--dns 223.5.5.5参数,或在/etc/docker/daemon.json里全局配置 DNS
真正卡住的时候,别急着调 memory_limit 或重装 PHP —— 先查 dig packagist.org 和 composer config -g repo.packagist,90% 的问题出在这两个地方。










