主流中文镜像同步延迟实际为5–15分钟，并非实时；新包首波同步常失败，需等待下一轮轮询；composer update装不到新版主因是本地packages.json缓存默认15分钟不过期，应使用composer update --refresh（≥2.5）强制刷新元数据。
镜像同步延迟到底有多久？
主流中文镜像（阿里云、腾讯云、中科大）实际同步延迟是 2–10 分钟，不是宣传的“实时”——它们靠定时轮询 https://packagist.org/packages/list.json 或增量接口拉取变更，每 5–15 分钟 一次。新发布的包（尤其是刚打 git tag 的版本）首波同步失败很常见，得等下一轮或手动触发。
别信“5 分钟同步”的说法，得看具体包：访问镜像的 provider 地址，比如 https://mirrors.aliyun.com/composer/p2/laravel/framework/11.0.0.json，如果返回 404 而官方源返回 200，说明确实没同步到，不是你本地问题。
为什么 composer update 还是装不到最新版？
镜像延迟只是表象，真正卡住你的往往是缓存机制：
-
composer clear-cache只清 ZIP 包和部分 provider 缓存，不碰packages.json元数据——它默认 15 分钟内复用，哪怕镜像已更新也不会重拉 - Composer 缓存元数据在
~/.composer/cache/repo/https---mirrors-aliyun-com-composer这类路径下，删掉整个子目录才有效 - 项目级
"repositories"字段会完全屏蔽全局镜像配置，哪怕你全局配了阿里云，只要composer.json里有这个字段，就走不到镜像
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空、null 或字符串 "https://packagist.org"，说明根本没配成功。
composer update --refresh 是什么，什么时候用？
这是 Composer ≥ 2.5 唯一能精准刷新元数据的操作，不是噱头：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它丢弃所有缓存的
packages.json和provider-*.json，强制从当前配置的镜像源重新下载最新索引 - 不重下 ZIP 包，只解决“镜像已有 v2.3.0，
composer update vendor/pkg却说Nothing to install”这类问题 - 执行前务必确认
composer config -g repo.packagist输出的是有效镜像地址；老版本（≤2.4）不支持该参数，只能手动删缓存目录
注意：--no-cache 参数也能跳过缓存，但每次都会重拉元数据，影响效率，仅适合临时调试。
哪些情况必须切回 Packagist 官方源？
中文镜像再快，也覆盖不了这些场景：
- 包作者刚
git push --tags，但还没在 Packagist 后台点 “Update”——Packagist 不自动监听所有仓库 - 用了私有 GitLab/GitHub 仓库 +
"repositories"自定义源，镜像完全不代理这类地址 - 依赖中含
"minimum-stability": "dev"且分支名非常规（如feat/new-api），部分镜像解析逻辑不兼容
临时切回官方源只需一行：composer config -g repo.packagist composer https://packagist.org，用完再切回来即可。但要注意：国内直连常超时或 503，此时不是镜像的问题，而是网络链路本身不可靠。
最易被忽略的点：镜像 URL 必须以 / 结尾，写成 https://mirrors.aliyun.com/composer（少斜杠）会导致 Composer 2.2+ 静默降级回官方源，且不报错——这种错误只能靠 composer config -g repo.packagist 输出来发现。
