中科大Composer镜像源地址必须为https://packagist.mirrors.ustc.edu.cn/（末尾带斜杠），否则拼接路径错误导致404；需验证全局配置、排除项目级覆盖、检查镜像可达性与同步状态，并用composer update --refresh强制刷新元数据。
确认中科大源地址是否正确且带斜杠
中科大镜像源地址必须是 https://packagist.mirrors.ustc.edu.cn/（注意末尾的 /），少一个斜杠就会导致 Composer 拼出错误路径如 /composerpackages.json，直接返回 404，但现象常被误判为“超时”。运行 composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://packagist.mirrors.ustc.edu.cn/"}。如果显示空、null、https://packagist.org 或报错，说明配置根本没写进去。
检查是否被项目级配置覆盖
只要项目根目录的 composer.json 中存在 "repositories" 字段（哪怕只是空数组 []），全局镜像配置就会被完全忽略。此时需运行 composer config repo.packagist（不带 -g）查看实际生效的配置。常见诱因包括：用 laravel new 初始化过、从旧模板拷贝了 composer.json、或执行过 composer config repositories...。解决方法是临时重命名项目中的 composer.json，再试 composer require monolog/monolog -vvv 看请求域名是否变成 packagist.mirrors.ustc.edu.cn。
验证镜像本身是否可达且同步正常
中科大源虽稳定，但并非永远在线。执行以下两步快速验证：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
curl -I https://packagist.mirrors.ustc.edu.cn/packages.json—— 应返回HTTP/2 200；若超时、403 或 404，说明镜像暂时不可用 - 打开浏览器访问
https://packagist.org/packages/topthink/think和https://packagist.mirrors.ustc.edu.cn/p/topthink/think.json，对比最新版本号是否一致；若官网已有 v6.1.5 而镜像站仍显示 v6.1.4，且已超过 30 分钟，属同步异常，需换源
当前（2026年10月）实测可用的备用源有：https://mirrors.tuna.tsinghua.edu.cn/composer/、https://mirrors.cloud.tencent.com/composer/、https://packagist.mirrors.sjtug.sjtu.edu.cn/。
强制刷新元数据并绕过本地缓存
Composer 默认复用本地 packages.json 缓存（15 分钟 TTL），即使你刚换了镜像，它也可能继续用旧索引去请求官方源。不要只依赖 composer clear-cache —— 它不清理元数据缓存。正确做法是：
- Composer ≥ 2.5：
composer update --refresh（强制重拉所有 provider 和 packages.json） - Composer rm -rf $(composer config --global cache-dir)/repo/https---packagist-mirrors-ustc-edu-cn
- 调试时加
--no-cache -v参数，终端日志第一行的Downloading https://...必须明确显示中科大域名
真正卡住的地方往往不是下载 ZIP 包，而是反复请求元数据失败后自动 fallback 到 packagist.org —— 这个过程静默发生，日志里只显示“Retrying”或“Connection timed out”，容易误以为是网络问题。
