答案是composer update --refresh（≥2.5）可强制刷新元数据：它丢弃缓存的packages.json，重新下载最新镜像源元数据，不重下zip包；老版本需手动删缓存目录或设composer_cache_dir=/dev/null。
Composer 无法获取远程元数据，不是“连不上网”，而是它压根没去请求远程——默认复用本地缓存的 packages.json，哪怕镜像站上已更新新版本，它也视而不见。
为什么 composer update 不拉新 metadata？
Composer 在执行前会检查缓存目录下对应镜像源的 packages.json（比如 ~/.composer/cache/repo/https---mirrors.aliyun.com-composer/）。只要该文件存在且未超时（默认 15 分钟），就直接读缓存，跳过网络请求。
- 现象：Packagist 页面显示
monolog/monolog已发布3.6.0，但composer update monolog/monolog却提示 “Nothing to install or update” - 根本原因：缓存里仍是旧版
packages.json，里面根本没有3.6.0的记录 - 注意：
composer clear-cache会清掉这个文件，但下次update运行时又立刻重建并复用——除非你强制打断这个逻辑
composer update --refresh 是什么，能解决吗？
composer update --refresh（仅 Composer ≥ 2.5 支持）是专为同步延迟设计的开关：它强制丢弃所有已缓存的 packages.json，重新从当前配置的镜像源下载最新元数据，但不碰 ZIP 包缓存。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它不会重下任何包，只刷新“有哪些版本可用”这个信息
- 执行后立刻再跑
composer update vendor/package-name，就能识别出新版本 - 确保
composer config -g repo.packagist输出的是你期望的 HTTPS 地址（如https://mirrors.aliyun.com/composer/），否则--refresh会去错地方拉 - Composer 2.4 及更早版本不支持该参数；老版本只能手动删缓存目录里的
repo/子目录，或临时用COMPOSER_CACHE_DIR=/dev/null composer update
为什么换镜像源后还是拉不到新包？
换源本身不等于元数据立即刷新。即使你刚切到清华源，Composer 仍可能继续读旧缓存（比如之前用的是阿里云源，缓存路径不同但 Composer 没自动切换读取目标）。
- 先确认当前生效镜像：
composer config -g repo.packagist - 查缓存根目录：
composer config --global cache-dir - 进缓存目录看具体子路径：
ls -l $(composer config --global cache-dir)/repo/，你会看到类似https---mirrors-tencent-com-composer这样的文件夹 - 如果发现多个镜像缓存共存，
--refresh只清理当前配置镜像对应的packages.json，不会误删其他源的缓存
metadata 请求失败，真是网络问题吗？
报错说“无法获取 metadata”，常被误判为网络不通，其实多数时候是 HTTPS 协议层卡住：HTTP 镜像被拦截、TLS 握手失败、证书校验不通过，但 Composer 默认静默 fallback 到缓存，不报明确错误。
- 运行
composer config -g repo.packagist，输出必须是以https://开头；若含http://，立刻修正 - 加
-vvv参数看真实请求：composer update -vvv，重点观察是否出现Downloading https://行，以及状态码是不是200或304 - 如果看到
Failed to connect或卡在Resolving packagist.org，问题不在 Composer，而在 DNS 或 TLS 层；此时应先跑curl -I https://mirrors.aliyun.com/composer/packages.json验证底层连通性
最易被忽略的一点：元数据刷新和包下载是两件事——--refresh 只管前者，而后者是否成功，还取决于镜像是否真同步了那个包、URL 是否拼对、私有源是否配了 type 和认证。别把“看到新版本”当成“一定能装上”。
