唯一可靠验证方式是执行composer config -g repo.packagist，输出必须为完整json对象如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、字符串或官方源url均说明配置未生效，再结合-vvv日志和curl直连进一步确认实际请求与网络通路。
直接看全局配置输出是否为完整 JSON
执行 composer config -g repo.packagist 是唯一能快速确认镜像是否“写对”的方式。它不依赖网络、不查缓存，只读 ~/.composer/config.json 里那一行。
必须看到形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象才算成功。其他情况全是失败信号：
- 输出为空、
null或报错Key "repo.packagist" does not exist→ 配置根本没写进去 - 只返回字符串，比如
"https://mirrors.aliyun.com/composer/"→ 缺type字段，Composer 2.0+ 会静默忽略 - 返回
{"type": "composer", "url": "https://packagist.org"}→ 还在用官方源，镜像未启用
常见踩坑点：repo.packagist 写成 repos.packagist（多一个 s）、漏掉 -g、URL 少末尾 /、PowerShell 下没加引号导致 URL 截断。
用 -vvv 日志确认真实请求发往哪个域名
配置写了 ≠ 请求真发过去了。缓存、项目级 repositories、环境变量都可能绕过你设的地址。
运行 composer install -vvv 2>&1 | grep "GET\|Downloading"（Linux/macOS）或 composer install -vvv | findstr "GET Downloading"（Windows），重点盯日志里的域名：
- 看到
GET https://mirrors.aliyun.com/composer/或类似路径 → 镜像正在用 - 看到
GET https://repo.packagist.org/或Downloading https://api.packagist.org/→ 配置被覆盖或未生效 - 卡在
Resolving dependencies阶段 → 和镜像无关，是依赖解析逻辑问题
注意：composer install -vvv 必须在项目根目录下执行，否则可能读到项目级配置；如果项目 composer.json 里有 "repositories" 字段（哪怕值是 {} 或 []），全局镜像会被无条件屏蔽。
用 curl -I 直连镜像端点验证网络通路
浏览器访问不可靠，很多镜像会根据 User-Agent 拒绝请求。必须模拟 Composer 的真实行为：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
执行 curl -I -H "User-Agent: Composer/2.9.6" -H "Accept: application/json" https://mirrors.aliyun.com/composer/packages.json
关键看三件事：
- 是否出现
Connected to mirrors.aliyun.com→ DNS、TLS、路由都通 - 响应码是否为
HTTP/2 200或HTTP/1.1 200 OK→ 镜像服务正常 - 是否有
Content-Type: application/json→ 返回的是有效元数据，不是 HTML 重定向页
若返回 404，大概率是 URL 少了 /packages.json 后缀；若超时或 Could not resolve host，说明本地网络策略（代理、/etc/hosts、DNS 污染）在干扰，和 Composer 配置无关。
别信 composer diagnose 和 composer validate
这两个命令完全不读镜像配置，也测不了网络连通性。
composer diagnose 强制访问 https://packagist.org，哪怕你配了清华源，它也可能报 Failed to connect to packagist.org ——这不是故障，是设计如此。它真正检查的只有 PHP 版本、OpenSSL 是否可用、curl 扩展是否存在。
composer validate 只校验当前目录下 composer.json 的语法和字段名白名单，对 config.json、auth.json、repositories 里的 URL 格式、type 值合法性等一概不管。
真正暴露问题的是 composer install --dry-run：它走完整依赖求解流程但不写文件，是检验配置是否“能用”的最小闭环。
