唯一可靠验证方式是运行composer config -g repo.packagist，输出必须为完整json对象如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、字符串或含packagist.org均说明未成功写入。
运行 composer config -g repo.packagist 看输出是否为完整 JSON
这是验证配置是否写入成功的**唯一可靠方式**，不是看安装快慢、也不是看 composer diagnose 是否报错。命令必须带 -g，键名必须是 repo.packagist（单数，不能多写一个 s）。输出必须形如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
常见失败现象：
- 返回空、
null或提示Key "repo.packagist" does not exist→ 配置根本没写进去，检查拼写、斜杠、是否漏-g - 只返回字符串，如
"https://mirrors.aliyun.com/composer/"→ 缺少"type": "composer"字段，配置不完整 - 返回
{"type":"composer","url":"https://packagist.org"}→ 还在用官方源，镜像未生效
用 composer install -vvv 抓真实请求日志
配置“存在”不等于“生效”。项目级 composer.json 里的 repositories 字段会无条件覆盖全局镜像，此时 config -g 显示正确也白搭。
执行：composer install -vvv 2>&1 | grep "Downloading\|GET"（Linux/macOS）或 composer install -vvv | findstr "Downloading\|GET"（Windows），重点观察：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 是否出现类似
Downloading https://mirrors.aliyun.com/composer/packages.json的行 → 镜像正在用 - 如果看到
packagist.org或请求卡在Resolving dependencies后无后续 → 镜像未生效，或被项目配置屏蔽 - 日志里第一个
packages.json请求最关键，它决定后续所有 provider 查询走哪条路
用 curl -I 和 curl -s 验证镜像端点可用性与同步状态
浏览器访问不可靠，很多镜像会根据 User-Agent 拒绝请求。必须用 curl 模拟 Composer 行为：
-
curl -I https://mirrors.aliyun.com/composer/packages.json→ 必须返回HTTP/2 200或HTTP/1.1 200 OK；404 通常是因为 URL 少了末尾/；超时或Could not resolve host是网络策略问题 -
curl -s https://mirrors.aliyun.com/composer/packages.json | jq -r '.lastModified'对比官方源：curl -s https://packagist.org/packages.json | jq -r '.lastModified'→ 差值 ≤ 180 秒才可信 - 查具体包是否同步：
curl -s https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3，和官方源同命令结果逐行比对，缺版本即同步滞后
手动清理元数据缓存再重试
composer clear-cache 几乎无效——它只删 ZIP 包和 dist 缓存，不影响 packages.json 和 provider-*.json。真正卡住你的，是本地缓存的旧索引。
- 先查路径：
ls -d $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer（URL 中/被转义为---） - 再删除：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - Windows 用户路径类似：
%APPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer - 删完立刻跑
composer show monolog/monolog，Composer 会强制重拉最新元数据
同步延迟常被误判为配置失败，但其实最常卡在元数据缓存没清、packages.json 复用逻辑没绕过、或项目级 repositories 静默覆盖这三点上。
