答案是dns解析失败或网络策略拦截导致，需先用ping、curl验证连通性，再正确配置镜像源（键名repo.packagist、type值composer、url末尾带/）、清缓存并排除代理与防火墙干扰。
composer install报错“Could not resolve host”或“Connection refused”
这不是 Composer 坏了，而是请求根本没发出去——DNS 解不出来、防火墙拦了 443 端口、杀毒软件（如火绒/360）拦截 HTTPS、或公司中间人代理篡改证书。先别急着换源，做两件事：ping packagist.org 和 curl -I https://packagist.org/packages.json。如果 ping 返回 unknown host，说明 DNS 污染；如果 curl 卡住或报 Failed to connect，基本是防火墙或代理问题。切手机热点一试便知是不是内网策略限制。
镜像配置写错导致静默回退到官方源
Composer 2.x 会安静地 fallback 到 https://packagist.org，不报错也不提醒。验证是否真生效，只看这一条命令输出：composer config -g repo.packagist。返回空、null 或 Key not found 就说明没写进去。常见错误有三个硬性条件全中：
- 键名必须是
repo.packagist（不是repos.packagist，也不是repositories.packagist.org） -
composer是type值，必须显式写出，漏掉就失效 - URL 必须 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼成/composerpackages.json导致 404）
正确命令就是：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后仍报 404、SSL 错误或 JSON decode error
这不是网络不通，而是缓存残留或元数据损坏。镜像同步有延迟，旧 composer.lock 里硬编码了官方源路径，Composer 拿着它去新镜像上找包，自然 404。必须三步一起做：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer clear-cache（Windows 还得手动删%LOCALAPPDATA%\Composer\cache） - 删掉
vendor/和composer.lock - 再跑
composer install
顺便验证镜像本身是否可用：curl -I https://mirrors.aliyun.com/composer/packages.json 应返回 HTTP/2 200；若返回 HTML 页面（比如人机验证），说明该镜像不适合自动化场景，换腾讯云或华为云源试试。
项目级配置覆盖全局镜像
哪怕 composer.json 里只写了 "repositories": []，也会完全屏蔽全局镜像。检查是否存在：grep -n "repositories" composer.json。临时清掉项目级配置用：composer config --unset repositories（注意没 -g）。CI/CD 或宝塔环境更麻烦：你用 root 配的全局镜像，但实际运行的是 www 用户，得用 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 单独配。
最容易被忽略的是：换镜像只解决元数据拉取和 ZIP 下载慢的问题，不解决 Resolving dependencies 卡住。如果卡在这一步几十秒，大概率是 composer.json 里写了太宽泛的 PHP 版本约束（比如 "php": "^7.4 || ^8.0"）或者一堆未锁定的 dev-main 分支，跟镜像无关。
