“could not resolve host”不是composer错，是dns卡死导致域名无法解析，必须先用nslookup或dig验证mirrors.aliyun.com和repo.packagist.org是否可解析，再排查dns污染、hosts绑定、镜像配置残留及网络策略干扰。
“Could not resolve host”不是Composer错，是DNS卡死了
报这个错时，Composer根本没发出HTTP请求——它连域名都解析不出来，后续所有配置、超时、镜像切换全无效。别急着改composer.json或composer config，先确认系统是否能解析mirrors.aliyun.com和repo.packagist.org。
用这两条命令直击问题本质：nslookup mirrors.aliyun.com 8.8.8.8（强制走Google DNS）nslookup mirrors.aliyun.com 1.1.1.1（强制走Cloudflare DNS）
如果其中一个返回ANSWER SECTION而另一个超时或无响应，说明你本地DNS被污染或不可靠；如果两个都失败，说明网络出口本身屏蔽了DNS查询。
- 别信“换镜像就能好”——
mirrors.tencent.com也是域名，一样要被解析 - 临时验证最快方式：切手机热点再跑
composer install，成功即锁定原网络DNS问题 - 某些企业网络会拦截53端口，此时
nslookup静默失败，需配合dig @8.8.8.8 mirrors.aliyun.com +tcp强制走TCP协议验证
手动hosts绑定是唯一绕过DNS单点的确定性手段
当DNS服务不可控时，写/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）是最直接的降噪方式，但极易因格式或权限失效。
GitHub Hosts 更新工具（仅限中国用户），安全更新系统hosts文件，保留原有非GitHub条目，仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。
操作前必须做三件事：
① 查实时IP：dig mirrors.aliyun.com +short @1.1.1.1（优先用Cloudflare，稳定性高）
② 确认只取IPv4地址（忽略AAAA记录），例如得到223.5.5.5
③ 编辑hosts时严格用空格分隔，禁止中文符号、制表符混用：223.5.5.5 mirrors.aliyun.com
- Windows保存失败？右键记事本→“以管理员身份运行”再编辑
- macOS/Linux改完必须刷新：
sudo dscacheutil -flushcache（macOS）或sudo systemd-resolve --flush-caches（systemd系） - hosts里同时写
packagist.org和github.com的IP，因为Composer依赖元数据和源码下载，两者缺一不可
Composer不支持自动hosts fallback，所谓“智能切换”是误解
不存在“DNS失败后自动读取备用hosts”的机制。系统层面的hosts文件是glibc（Linux）或Windows DNS Client服务在getaddrinfo()调用时统一加载的，Composer完全不参与该过程——它只管HTTP层，不管DNS层。
所谓“智能降噪切换”，实际是运维脚本+人工干预组合：
- 检测curl -I https://mirrors.aliyun.com/composer/packages.json是否返回Could not resolve host
- 若失败，自动注入最新IP到hosts并重试
- 成功后记录时间戳，定期轮询IP变更（阿里云镜像IP可能滚动）
- 别在
composer.json里堆多个repositories试图兜底——Composer只用第一个，失败就报错，不会尝试第二个 -
COMPOSER_MIRROR_PATH_REPOS环境变量不是故障切换开关，它只是控制镜像路径解析逻辑，不解决DNS问题 - 即使你全局配置了阿里云镜像，只要
mirrors.aliyun.com无法解析，composer install仍会卡死在第一步
真正可落地的降噪组合：DNS+hosts+超时三冗余
单一手段容易失效，必须分层防御：
第一层：系统DNS设为223.5.5.5（阿里云）+ 1.1.1.1（Cloudflare）双上游，避免单点失效
第二层：hosts文件预置3个主流镜像IP（阿里云、腾讯云、华为云），按顺序fallback
第三层：延长Composer超时，防止弱网下TLS握手慢触发误判：composer config -g http.timeout 600
- hosts中IP必须定期更新——阿里云镜像IP每月可能变更，建议每周用
dig +short mirrors.aliyun.com @1.1.1.1校验 - CI/CD中禁用DNS缓存：
echo 'nameserver 1.1.1.1' > /etc/resolv.conf，避免构建节点复用脏缓存 - 不要依赖
disable-tls true提速——它关的是证书校验，不是DNS，且带来中间人风险
最常被忽略的点：hosts文件修改后未刷新系统DNS缓存，或写入了IPv6地址却在IPv4-only网络下生效失败。验证永远从ping -4 mirrors.aliyun.com开始，而不是直接跑Composer。
