Composer更新不到新版本主因是本地packages.json缓存未刷新或项目级repositories配置覆盖全局镜像；需用composer config --list | grep repositories.packagist.url确认生效源， Composer ≥2.5 应执行composer update --refresh强制重载元数据。
Composer 更新不到新版本，90% 不是镜像没同步，而是你本地的 packages.json 缓存没刷新、或者项目级 repositories 配置把全局镜像盖掉了。
确认当前真正生效的镜像源
很多人改完 composer config -g repo.packagist 就以为搞定了，但实际请求根本没走你配的地址。关键看两点：
-
composer config --list | grep repositories.packagist.url—— 这才是真实生效的 URL，为空说明被项目级repositories字段屏蔽了 - 项目根目录的
composer.json里如果写了"repositories": [...]，它会**完全忽略**全局配置，哪怕你配了阿里云镜像也没用 - 键名必须是
repo.packagist（单数），写成repos.packagist在 Composer ≥2.2 里会静默失效 - 旧模板里残留的
"url": "https://packagist.phpcomposer.com"已停用，会导致 404 卡死
强制刷新元数据缓存，不是清整个 cache
composer clear-cache 没用——它删的是 ZIP 包和 provider 缓存，但 packages.json 默认 15 分钟内复用本地副本，根本不发网络请求。真正该做的是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Composer ≥2.5：直接运行
composer update --refresh，只丢弃packages.json和provider-*.json，不碰已下载包，快且精准 - Composer rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
- 临时调试可用
composer update --no-cache -v，看终端输出的GET https://...是否命中你预期的镜像地址
验证镜像是否真同步了你要的包
别只看网页界面，直接查元数据接口最准。比如要装 monolog/monolog v3.6.0：
- 阿里云镜像：
curl -s https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3 - 官方源对比：
curl -s https://packagist.org/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3 - 如果镜像返回里没有 v3.6.0，且已超 30 分钟，才算是镜像同步异常；否则就是你本地没刷新元数据
- 注意华为云镜像（
https://repo.huaweicloud.com/composer/）不托管 dist 包，只代理 metadata，下载阶段仍可能慢
私有包 tag 同步失败的特殊处理
私有 Git 仓库打的新 tag 始终不被识别？常见原因不是同步延迟，而是配置错位：
- 项目级
composer.json中的私有仓库必须声明"type": "vcs"，否则 Composer 直接跳过 Git tag 解析，fallback 到官方源或报错 - 全局镜像配置在私有包场景下完全无效，因为
"type": "vcs"的包不会走 Packagist 元数据流 - 确认 VCS 地址可访问：
git ls-remote https://your-gitlab-domain.com/group/repo.git --tags能列出新 tag 才算正常 - 老版本 Composer（--refresh 刷新私有仓库元数据，只能删缓存子目录：
rm -rf $(composer config --global cache-dir)/repo/https---your-gitlab-domain-com
最易被忽略的一点：项目级 repositories 字段一旦存在，就彻底接管所有包的源查找逻辑，连 composer config -g 显示的镜像地址都只是摆设。排查时第一件事不是换源或清缓存，而是先跑一遍 composer config --list | grep repositories.packagist.url 看它到底连哪儿去了。
