答案是dns污染或失效导致系统无法解析镜像域名ip，需先用ping、dig、curl验证dns层是否失败，再正确配置镜像源（键名repo.packagist、type为composer、url末尾带/）、清缓存并清理hosts及残留配置。
Could not resolve host 不是 Composer 配置错了，是系统压根没拿到镜像域名的 IP 地址——DNS 污染、失效或被劫持，导致所有后续请求全部卡死在第一步。
先确认是不是 DNS 层面真失败了
别急着改 composer.json 或重装 Composer。直接用系统命令验证 DNS 是否通：
-
ping mirrors.aliyun.com：返回unknown host→ 确实解析失败 -
dig mirrors.aliyun.com @8.8.8.8和dig mirrors.aliyun.com @114.114.114.114对比：一个有ANSWER SECTION，一个超时或空 → 本地 DNS 被污染或不可靠 -
curl -I https://mirrors.aliyun.com/composer/packages.json：报Could not resolve host或卡住 → 不是 HTTPS 问题，是 DNS 根本没通
临时绕过污染 DNS 快速验证镜像是否可用
不改系统设置也能快速判断：让请求走干净 DNS，排除干扰：
- Linux/macOS：
export CURL_CA_BUNDLE="" && curl --resolve mirrors.aliyun.com:443:223.5.5.5 -I https://mirrors.aliyun.com/composer/packages.json（223.5.5.5是阿里公共 DNS） - Windows CMD：
set HTTP_PROXY=http://127.0.0.1:8080+ 配本地代理（如 Proxifier + Cloudflare1.1.1.1）转发 DNS - 最简方式：切手机热点再跑一遍
composer install—— 成功就 100% 是原网络 DNS 或策略问题
正确配置镜像源，避免静默 fallback
很多人配了镜像却没生效，是因为键名、type、URL 三处任一写错都会导致 Composer 安静退回官方源：
- 键名必须是
repo.packagist（不是repos.packagist，也不是repositories.packagist.org） - 中间必须显式传入
composer作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，少斜杠会拼成/composerpackages.json导致 404 - 验证是否真写进去了：
composer config -g repo.packagist输出应为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
彻底清理残留配置与污染项
换镜像后还报错，往往不是地址不对，而是旧配置、缓存、/etc/hosts 或 fallback 在暗中作祟：
- 删三层配置：
composer config --global --unset repos.packagist.org（注意 key 是repos.packagist.org，不是repositories.packagist.org）；再检查项目级composer.json的repositories字段是否残留 - 清
/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）里所有含packagist.org、mirrors.aliyun.com的行 - 强制禁用 fallback 行为：Composer 2.2+ 默认会在主源慢时自动切回官方源，必须手动关掉
- 清缓存前先确认路径：
~/.composer/cache是默认位置（截至 2026 年 6 月 7 日）
真正难排查的 case 往往不在 Composer 层，而在系统或网络层——比如杀毒软件锁死 hosts 文件、企业防火墙静默拦截 443 请求、或 PHP 的 openssl.cafile 指向了过期证书。这些不会报错，但会让连接卡在 TLS 握手阶段，得单独验证。
