答案是composer默认复用15分钟内未过期的本地packages.json元数据缓存，导致即使镜像站已更新新版本，update仍按旧元数据计算而忽略新版本；解决方法为≥2.5版本执行composer update --refresh强制刷新元数据，老版本需手动删缓存目录或设composer_cache_dir=/dev/null。
国内镜像同步不及时不是常态，而是你本地没拿到最新元数据的表象——真正卡点在 Composer 自身缓存策略和配置覆盖逻辑，不是镜像站“懒”。
composer update 为什么看不到新版本？
Composer 默认复用本地 packages.json 元数据，15 分钟内不过期。哪怕阿里云镜像已同步 v3.6.0，你机器上缓存的仍是旧版索引，composer update 就不会发请求，自然装不到。
-
composer clear-cache只删 ZIP 和部分 JSON，不碰packages.json缓存，所以清完照样读旧数据 - 项目根目录有
"repositories"字段，会完全屏蔽全局repo.packagist配置，哪怕你配了阿里云，实际走的可能是已停用的https://packagist.phpcomposer.com - 老版本 Composer（--refresh，只能手动删缓存子目录，路径形如
$(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
怎么确认当前真在用预期镜像？
别信直觉或配置命令输出，要查生效链路：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config --list | grep repositories.packagist.url，输出必须是你配的地址（如https://mirrors.aliyun.com/composer/），空值说明被项目级配置覆盖 - 检查项目
composer.json是否含"repositories"字段；若有，确认其中没有"packagist.org": false或无效 URL - 用
curl -I https://mirrors.aliyun.com/composer/packages.json看是否返回HTTP/2 200；404 或超时说明镜像不可达，不是同步问题
强制刷新元数据的实操方式
“刷新镜像源”本质是让 Composer 重拉 packages.json 和 provider-*.json，不是调服务端同步：
- Composer ≥ 2.5：直接跑
composer update --refresh，它只丢弃元数据缓存，不删已下载包，快且精准 - Composer --no-cache -vvv 跑安装，观察日志里
Downloading行是否命中你的镜像域名 - 临时调试可用
composer show vendor/package --no-cache，触发单包元数据重载，比全量更新轻量
镜像同步本身到底多慢？
主流镜像（阿里云、腾讯云、华为云）实际同步延迟通常 2–10 分钟，5–15 分钟轮询一次 Packagist 接口。所谓“半小时没更新”，八成是本地缓存或配置问题，不是镜像站异常。
- 新发布的包（尤其是
dev-分支或刚git tag的版本）首波可能失败，需等下一轮同步或手动触发 - 镜像不代理私有 VCS 源、
type: package自定义仓库、废弃包（abandoned），这些会 fallback 到官方源，而国内直连常超时，造成“找不到包”的假象 - 若镜像站同包地址（如
https://mirrors.cloud.tencent.com/composer/p/vendor/package.json）返回 404，但官网已有新版，才属真实同步卡顿，此时可临时切回官方源：composer config -g repo.packagist composer https://packagist.org
最易被忽略的是项目级 repositories 字段对全局配置的彻底屏蔽，以及 packages.json 缓存的 15 分钟硬性有效期——这两点不处理，换再快的镜像也没用。
