答案是DNS解析失败导致请求无法发出，应优先验证域名解析、正确配置阿里云等国内镜像（键名repo.packagist、type为composer、URL以/结尾）、清除缓存并检查hosts文件。
Composer install卡在“Could not resolve host”就是DNS没通
不是 Composer 本身坏了，而是它根本没发出去请求——packagist.org 或镜像域名（如 mirrors.aliyun.com）连 IP 都没解析出来，后续所有步骤全被拦在第一步。
常见现象包括：Could not resolve host: packagist.org、Failed to connect to mirrors.aliyun.com port 443: Connection refused（注意：这个错误常被误读为端口不通，实际是 DNS 失败后 cURL 用空地址建连失败）。
- 运行
ping packagist.org返回unknown host→ 确认 DNS 层失效 -
dig packagist.org @114.114.114.114有结果，但@223.5.5.5超时 → 本地 DNS 被污染或不可靠 - 浏览器能打开
https://mirrors.aliyun.com/composer/，但composer install报错 → Composer 没走浏览器的 DNS 缓存，它依赖系统 resolver
为什么换镜像源能绕过 DNS 问题
阿里云、清华等镜像域名（如 mirrors.aliyun.com）在国内 DNS 解析成功率远高于 packagist.org，且 CDN 节点更近。但前提是配置必须写对，否则等于没换。
关键三要素缺一不可：
- 键名必须是
repo.packagist（不是repos.packagist.org，也不是repositories） - type 值固定为
composer（命令里不能省略这个词） - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404）
验证是否生效：composer config -g repo.packagist 应输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
为什么清缓存和删 hosts 很关键
Composer 2.2+ 默认启用 fallback 机制：即使你配了镜像，只要主源响应慢（比如 DNS 卡住），它会悄悄切回官方源重试——而你根本看不到日志提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
残留配置会让整个流程失效：
- 项目级
composer.json里残留"repositories"字段，可能覆盖全局设置 -
/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）里有127.0.0.1 packagist.org这类条目，直接制造重定向循环 - 旧缓存里存着失败的 DNS 查询记录，
composer clear-cache才能强制刷新
别跳过这步：删缓存前先确认路径是 ~/.composer/cache（截至 2026 年 8 月仍为默认）。
curl 测试比 composer diagnose 更准
composer diagnose 里 “HTTPS connectivity to packagist.org failed” 只说明它仍在尝试连官方源，并不等于你不能用镜像——它根本没测你配的镜像是否可用。
直接用 curl 绕过 Composer 层验证最可靠：
-
curl -I https://mirrors.aliyun.com/composer/packages.json→ 看 HTTP 状态码（200 才算通） -
curl -v https://mirrors.aliyun.com/composer/→ 观察 * Connected to 和 * TLS handshake 是否卡住，卡在后者说明证书或中间人代理干扰 - 加
--resolve强制指定 IP：curl --resolve mirrors.aliyun.com:443:223.5.5.5 -I https://mirrors.aliyun.com/composer/packages.json，可快速排除 DNS 污染
真正难搞的 case，往往卡在系统层：杀毒软件锁死 hosts、企业代理静默替换证书、OpenSSL 版本对 SNI 支持异常——这些都得靠 curl 直击底层才能暴露。
