Composer 配置镜像必须带末尾斜杠，否则路径拼接错误导致静默回退；元数据缓存硬编码15分钟，仅composer update --refresh可精准刷新，手动清缓存无效。
composer config --global repo.packagist 必须带末尾斜杠
不加 / 会导致 Composer 拼接出错路径，比如把 https://mirrors.aliyun.com/composer 和 packages.json 连成 https://mirrors.aliyun.com/composerpackages.json，直接 404。此时 Composer 不报错，而是静默 fallback 到 repo.packagist.org，你根本不知道自己没走镜像。
正确写法只有一种：composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/（注意结尾的 /）。
- 验证是否生效：运行
composer config --global repo.packagist，输出必须是完整 JSON 对象，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} -
composer diagnose显示 “Repo packagist.org is default” 就说明配置失败 - 项目级
composer.json中若存在"repositories"字段，会彻底屏蔽该全局配置，哪怕 URL 正确也无效
元数据缓存硬编码为15分钟，不可调也不可绕过
Composer 客户端对 packages.json 和所有 provider-*.json 的缓存策略是硬编码的：15 分钟内绝不重发 HTTP 请求。这不是 bug，是设计——它不管镜像站是否已同步，只看本地文件时间戳。
所以你看到“阿里云说已同步”，但 composer update 仍装不到新版本，大概率只是因为本地缓存还没过期。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer clear-cache对元数据完全无效，它只删 ZIP 包和部分临时 JSON - 没有
--cache-ttl或cache-interval这类配置项，所有“调刷新频率”的尝试都是徒劳 - 真实缓存路径在
$(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer/下，packages.json和provider-*.json都在这里
composer update --refresh 是唯一可靠元数据刷新手段
composer update --refresh（仅 Composer ≥ 2.5 支持）是目前最轻量、最精准的元数据刷新方式：它只删除 repo/ 子目录下的 packages.json 和全部 provider-*.json，强制从当前生效镜像源重拉索引，但保留已下载的 ZIP 包缓存。
它不解决镜像站本身未同步的问题，但它能确保你本地拿到的是“镜像站此刻能给的最新元数据”。
- 执行前务必确认
composer config --global repo.packagist输出是你期望的地址 - 若项目
composer.json含"repositories"，需改用composer config repo.packagist（不带-g）查项目级配置 - 老版本（≤2.4）只能手动清理：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - 加
--no-cache -vvv可在终端日志里确认请求 URL 是否命中你的镜像域名
镜像不是代理，元数据一致性需逐文件校验
国内镜像不是反向代理，而是对 Packagist 元数据的全量定时同步。这意味着 packages.json 更新了，不代表 p2/laravel/framework/10.0.0.json 也同步了——它们是独立文件，由不同任务触发拉取。
所谓“同步不及时”，往往是你依赖的那个 provider-*.json 文件还没生成或没推送到边缘节点。
- 验证某包是否可用：用
curl -I https://mirrors.aliyun.com/composer/p2/vendor/package/1.2.3.json看是否返回200，而非只测packages.json - 比对版本列表是否一致：
curl -s https://packagist.org/p2/vendor/package.json | jq -r '.packages."vendor/package" | keys[]' | sort和镜像站同命令结果逐行比对 - 响应头中的
Last-Modified滞后超过 180 秒，或Age值过大（如Age: 1800），说明你命中的 CDN 节点缓存严重滞后 - 别信镜像首页显示的“最后同步时间”，那是主节点时间，不反映你实际访问到的边缘节点状态
