“Could not resolve host”本质是DNS解析失败，需优先排查DNS配置、hosts文件、nsswitch.conf顺序、systemd-resolved服务及临时指定DNS五类原因，而非直接更换镜像源。
“Could not resolve host”不是镜像问题，是DNS卡死了
遇到镜像还原（比如切回官方源或换新镜像）时提示 Could not resolve host: packagist.org 或 Could not resolve host: mirrors.aliyun.com，第一反应不该是“镜像挂了”或“配置写错了”，而是系统根本没拿到域名对应的 IP。DNS 解析失败会阻塞整个链路——哪怕你配的是阿里云镜像，composer install 仍要先解析 mirrors.aliyun.com 才能发 HTTPS 请求。
常见错误现象包括：
- 终端卡在
Loading composer repositories，无任何后续日志 -
composer diag显示正常，但composer clear-cache卡住不动 - 改了
repos.packagist配置，composer config -g repos.packagist输出正确，可实际请求 URL 仍是https://packagist.org/
此时别急着删 vendor 或重装 Composer，先确认 DNS 是否通：
- 运行
ping -c 1 packagist.org：若返回unknown host，说明 DNS 解析失败 - 运行
nslookup mirrors.aliyun.com 114.114.114.114：若返回 IPv4 地址，说明干净 DNS 可用；若本地不加 DNS 参数就超时，基本就是 DNS 污染 - 执行
dig mirrors.aliyun.com @223.5.5.5 +short获取真实 IP，再用curl -I --resolve mirrors.aliyun.com:443:<code>IPhttps://mirrors.aliyun.com/composer/packages.json 直连验证——返回HTTP/2 200就证明镜像服务本身完全正常
镜像还原后仍走 packagist.org？检查三处配置优先级
你以为切回了官方源，但日志里还在请求 https://packagist.org/，大概率是配置被覆盖了。Composer 的镜像源加载顺序非常明确，低优先级配置会被高优先级直接忽略。
-
composer config -g repos.packagist是全局配置，但只要项目根目录composer.json中存在"repositories"字段（哪怕只是{}或[]），它就会被彻底屏蔽 - 运行
composer config repo.packagist（不带-g）查看当前项目实际生效的配置，有输出就说明项目级配置在起作用 - 某些 IDE 或脚本会自动生成
repositories块，手动删掉整段再试，不要只清空内容 - URL 必须以
https://开头、结尾带/，例如https://repo.packagist.org/，少斜杠会导致拼出非法路径，最终 fallback 到默认源
删了缓存还走旧镜像？元数据缓存没清干净
composer clear-cache 只清 ~/.composer/cache/files/ 和部分 provider 缓存，但最关键的元数据快照（如 packages.json）仍留在 ~/.composer/cache/repo/ 下对应子目录中，且默认 15 分钟内不过期。镜像还原后如果仍按旧索引算依赖，就会出现“明明新版本已发布，composer show 却查不到”的情况。
- 查当前镜像缓存路径：
ls -d ~/.composer/cache/repo/https---*（Linux/macOS）或dir "%APPDATA%\Composer\cache\repo\https---*"（Windows） - 删掉对应镜像的整个目录，例如还原到官方源后，删掉
https---packagist.org；切到清华源后，删掉https---mirrors.tuna.tsinghua.edu.cn-composer - Composer ≥ 2.5 可跳过手动删除，直接运行
composer update --refresh强制丢弃所有元数据缓存 - 删完务必跑一次
composer show monolog/monolog -v，观察日志是否出现Downloading https://...——只有看到这行，才说明元数据真的重拉了
systemd-resolved 和 /etc/resolv.conf 冲突怎么办
Linux 上很多发行版（如 Ubuntu 20.04+）默认启用 systemd-resolved，它会接管 /etc/resolv.conf 并指向 127.0.0.53，导致你手动改的 nameserver 不生效。这是国内用户镜像还原失败最隐蔽的原因之一。
- 检查是否被接管：
ls -l /etc/resolv.conf，若输出含-> /run/systemd/resolve/stub-resolv.conf，说明已被覆盖 - 临时解决：运行
sudo systemctl stop systemd-resolved，再写入 DNS：echo "nameserver 223.5.5.5" | sudo tee /etc/resolv.conf - 永久解决：禁用服务并重建
resolv.conf：sudo systemctl disable systemd-resolved，然后sudo rm /etc/resolv.conf && echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf - macOS 用户注意：
scutil --dns查看实际生效的 DNS，有时 Network Preferences 设置了，但 mDNSResponder 没刷新
