答案是本地元数据缓存未刷新——需用composer update --refresh（≥2.5）或手动删除~/.composer/cache/repo/下对应镜像子目录，同时确认composer config -g repo.packagist输出正确JSON且项目级repositories未覆盖全局配置。
镜像源配置正确 ≠ 元数据实时同步，你遇到的“找不到新包”“update 还是旧版本”，90% 是本地元数据缓存没刷新，不是镜像没更新。
确认当前真正生效的镜像地址
很多人改完配置就跑 composer update，结果还是走 https://packagist.org —— 因为配置根本没生效。
- 运行
composer config -g repo.packagist查全局配置；如果项目目录下有composer.json且含repositories字段，则必须用composer config repo.packagist（不带-g）查项目级配置 - 输出必须是完整 JSON，形如
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空、null或报错，说明配置失败 - 键名必须是
repo.packagist（单数repo），写成repos.packagist会静默失败，且无提示 - 项目级配置中，
"repositories"必须是数组，且首项必须显式禁用官方源：{"packagist.org": false}，否则 Composer 2.2+ 仍硬编码请求官方地址
验证镜像是否真通、真同步
配置对了 ≠ 能用。得手动确认两点：连得上、数据新。光看命令返回成功没用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -I https://mirrors.aliyun.com/composer/packages.json检查 HTTP 状态码，必须是HTTP/2 200；403/404/超时都说明镜像不可用 - 对比同一包在官方和镜像的 provider 文件：
curl -s https://packagist.org/p/vendor/pkg.json | jq -r '.packages."vendor/pkg" | keys[]' | sort | tail -3和curl -s https://mirrors.aliyun.com/composer/p/vendor/pkg.json | jq -r '.packages."vendor/pkg" | keys[]' | sort | tail -3；后者缺失最新版本号，就是镜像尚未同步（通常滞后 2–15 分钟） -
composer diag完全不测镜像——它默认只连https://packagist.org，返回 “Connection failed” 只反映本地环境问题（curl/OpenSSL/系统时间），不代表镜像挂了
强制刷新元数据，不是清缓存那么简单
composer clear-cache 只删 ZIP 包和部分 provider 缓存，对决定“有没有这个包”的 packages.json 和 provider-*.json 几乎无效。这些文件存在 ~/.composer/cache/repo/https---mirrors.aliyun.com-composer 这类路径下。
- Composer ≥ 2.5：直接用
composer update --refresh，它丢弃所有缓存的元数据文件，强制从当前配置镜像源重拉最新索引，但保留已下载的 ZIP 包 - Composer rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
- 临时调试加
--no-cache -v，终端输出里搜GET https，确认请求 URL 是否命中你配的镜像地址 - 别信“一键刷新脚本”——客户端没有任何命令能触发镜像服务器同步，你只能控制自己怎么重拉
换源比等更可靠，但要注意 URL 细节
不同镜像站（阿里云、腾讯云、中科大）轮询节奏不同，同一时刻查到的版本可能差几个小时。新包发布后卡住，换源往往比干等快得多。
- 换源前先确认目标镜像可用：
curl -I https://mirrors.cloud.tencent.com/composer/packages.json返回 200 才继续 - URL 末尾必须带
/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会变成/composerpackages.json导致 404 - 项目级配置中，
"url"字段也必须带末尾斜杠，否则所有元数据请求失败 - CI/CD 环境（GitHub Actions、GitLab CI）默认不继承本地全局配置，必须在 workflow 中显式配置或用项目级
composer.json方式固化
最常被忽略的是：镜像同步延迟是服务端机制所致，无法绕过；你能控制的只有本地如何重拉最新元数据。一旦发现新包查不到，优先执行 composer update --refresh，再检查镜像 URL 格式和 repositories 数组结构，而不是反复清缓存或怀疑网络。
