答案是DNS解析失败或系统级拦截导致，需先用ping、curl验证连通性，再检查镜像配置三要素（键名repo.packagist、type值composer、URL末尾带/），清缓存并排除代理、防火墙及项目级repositories字段干扰。
不是网络切换本身出问题，而是新网络环境触发了 Composer 原本被掩盖的配置缺陷或系统级拦截
报 “Could not resolve host” 或 “Connection refused”
这类错误说明请求根本没发出去，和 Composer 无关，是系统连通性断在底层：
- 运行
ping packagist.org—— 如果返回unknown host，就是 DNS 解析失败；换 DNS（如8.8.8.8）比改 Composer 配置更直接 - 运行
curl -I https://packagist.org—— 如果卡住或报Failed to connect，大概率是防火墙、杀毒软件（火绒/360）、企业 HTTPS 解密代理（Zscaler 等）在拦 443 端口 - 浏览器能打开
https://packagist.org，但 Composer 报错 → 很可能是证书校验失败，不是镜像没配对，而是 PHP 的openssl.cafile指向了过期 CA 文件
明明配了阿里云镜像，却还去连 packagist.org
镜像配置静默失效，是 Composer 最坑人的设计之一：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist（不是repos.packagist，也不是repositories.packagist） - 中间必须显式传
composer作为type值：漏掉它，Composer 2.x 直接忽略该配置 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径时变成/composerpackages.json导致 404） - 验证是否真写进去了：
composer config -g repo.packagist输出必须是完整 JSON 对象，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或仍返回官方地址，说明没写对
项目级 repositories 字段让全局镜像完全失效
只要项目根目录 composer.json 里有 "repositories" 字段（哪怕只是 "repositories": []），全局配置就彻底不生效 —— 不是优先级低，是直接跳过。
- 推荐做法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动合并到composer.json的repositories字段中，key 固定为"packagist" - 如果原
composer.json是"repositories": []，需先手动改为"repositories": {}再执行，否则报错 - CI/CD 或 Docker 中，
~/.composer可能根本不存在，项目级配置才是唯一可靠方式
“Content-Length mismatch” 或 vendor/autoload.php 为空
这不是网络切换导致的，而是缓存污染或下载中断后 Composer 没清理干净：
-
composer clear-cache必须执行 ——~/.composer/cache/files/下损坏的 zip 包会被复用，校验长度时直接报错 - 删掉整个
vendor/和composer.lock后重装，比反复重试更有效；composer.lock锁的是 commit hash，比仅靠composer.json更抗抖动 - 如果反复卡在同一个大包（比如
laravel/framework），可从composer.lock里取出dist.url，用wget -c手动下载，再放进对应vendor/name/hash/目录（仅限 CI 或顽固失败场景）
真正麻烦的从来不是“换网络”，而是旧配置在新环境下突然暴露：DNS 设置没同步、CA 证书过期、composer.json 里残留空 repositories 字段、缓存里躺着半截 zip 文件。这些点不逐个验证，光换镜像源只会让你以为它“有时灵有时不灵”。
