根本原因是composer默认复用15分钟内未过期的本地packages.json元数据缓存，不发起远程校验；解决需用composer update --refresh（≥2.5）强制刷新元数据，或手动删除对应repo缓存子目录。
镜像配置正确但 composer update 仍拉不到新版本，不是镜像没生效，而是 Composer 默认复用本地缓存的 packages.json 元数据（15 分钟内不过期），根本不去镜像站重新校验——哪怕阿里云镜像上已同步了 monolog/monolog v3.6.0，你本地还在按旧列表算。
为什么 composer update 显示 “Nothing to install or update” 却明明有新版本
根本原因是元数据缓存未刷新，不是网络或权限问题。Composer 启动时会检查 ~/.composer/cache/repo/https---mirrors-aliyun-com-composer/packages.json，只要存在且未过期，就跳过远程请求，直接用缓存里的版本列表做依赖计算。
- 现象：Packagist 页面和阿里云镜像站都显示
monolog/monologv3.6.0 已发布，但composer update monolog/monolog仍输出 “Nothing to install or update” - 验证方式：运行
curl -I https://mirrors.aliyun.com/composer/packages.json，若Last-Modified时间比你上次更新早，说明镜像已更新，但本地没拉 -
composer clear-cache无效：它会清掉 ZIP 包和 provider 缓存，但下次update会立刻重建packages.json并继续复用旧内容
composer update --refresh 是什么，为什么必须用它
composer update --refresh（Composer ≥ 2.5）是唯一精准解决元数据滞后的操作：它只丢弃所有缓存的 packages.json 和 provider-*.json，然后从当前生效的镜像源重新下载最新元数据，不碰 ZIP 缓存、不重装包、不重建 lock 文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行前先确认版本：
composer --version，低于 2.5 就得手动删缓存子目录 - 确保镜像真生效：
composer config -g repo.packagist输出必须是你配置的 URL（如https://mirrors.aliyun.com/composer/） - 项目级
repositories配置会覆盖全局设置，运行composer config --list | grep repositories.packagist.url确认没被覆盖 - 执行后立刻再跑
composer update vendor/package-name，新版本就能被识别出来
老版本 Composer（≤ 2.4）怎么强制刷新元数据
老版本不支持 --refresh，只能手动清理对应镜像的元数据缓存目录，否则缓存会持续复用。
- 查缓存根目录：
composer config --global cache-dir - 进
repo/子目录，找匹配镜像 URL 的文件夹（如https---mirrors-aliyun-com-composer） - 删除它：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - 别用
composer clear-cache代替——它清的是整个缓存，但重建时仍可能复用旧元数据逻辑 - 临时方案（不推荐长期用）：
COMPOSER_CACHE_DIR=/dev/null composer update，强制绕过缓存
为什么改了镜像，-vvv 日志里还在请求 packagist.org
不是镜像没换成功，而是项目级 repositories 配置优先级更高，只要 composer.json 里有该字段，全局设置就被完全屏蔽。
- 检查项目根目录
composer.json是否含"repositories"字段；若有，哪怕只写了{"packagist.org": false}，也会导致 fallback 到官方源 - 临时禁用项目级配置：
composer config --unset repositories（不加-g），再试update - 私有仓库、
path类型依赖、废弃包（abandoned）也会绕过镜像，直接回源拉取元数据 - 镜像同步本身有延迟（通常 5–30 分钟），
composer show vendor/package -vvv可观察真实请求域名，确认是否真在走镜像
真正卡住更新的从来不是命令本身，而是元数据缓存 + 配置优先级这两层隐性逻辑。很多人删了缓存、换了源、重启终端，问题还在，就是因为没意识到 packages.json 是独立缓存项，且项目级 repositories 会静默接管全部行为。
