Composer 3.x+元数据请求不走repositories列表，需用composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/配置全局镜像源，且URL末尾必须带/，并删除composer.lock与清缓存才能生效。
Composer 3.x+ 的元数据请求根本不走 repositories 列表
你往 composer.json 的 repositories 数组里加了阿里云镜像，composer install 还卡在 provider-laravel~10.0.json 上——这不是配置没生效，而是根本没走这条路。
Composer 2.2+ 开始把 Packagist 元数据源（packages.json、所有 provider-*.json）当作全局单例硬编码处理。repositories 只影响非 packagist 类型的私有源（比如 type: "vcs"），官方包的元数据请求完全绕过该列表，直连 repo.packagist.org。
真正能覆盖这个路由逻辑的，只有：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/- 这条命令写入的是全局配置，修改 Composer 内部元数据源的 base URL，后续所有 provider 查询、version metadata 请求都会发往镜像站
- 别手写
~/.composer/config.json：容易格式错、覆盖auth字段、引发权限问题 - 项目级配置用
composer config repo.packagist composer，但必须先确认composer.json里没声明packagist类型源，否则项目配置优先生效
Sync-on-request 不是实时同步，而是“首次请求触发镜像拉取”
所谓按需同步，是指镜像站收到对某个 p2/laravel/framework/10.0.0.json 的请求时，若本地没有，才反向拉取官方源对应文件并缓存。
这导致一个关键现象：镜像不是全量实时同步，而是存在滞后窗口。常见错误判断：composer diagnose 报 Could not fetch packages.json，很多人以为是网络不通，实际更可能是镜像尚未同步到你要的 provider 文件。
验证方式：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/p2/laravel/framework/10.0.0.json看是否返回 200 - 再比对官方源
curl -I https://repo.packagist.org/p2/laravel/framework/10.0.0.json - 如果官方有、镜像返回 404 或空响应，说明该镜像暂未同步，可临时切中科大源：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 别信
-vvv日志里 “Resolving dependencies” 那行——那只是开始，真正卡点在后续几百次 provider 请求，每个都可能触发一次镜像同步延迟
镜像 URL 末尾的 / 是硬性要求，不是风格问题
https://mirrors.aliyun.com/composer 和 https://mirrors.aliyun.com/composer/ 在 Composer 里是两个不同地址。缺斜杠会导致路径拼接错误。
例如请求 https://mirrors.aliyun.com/composerp2/monolog/monolog/2.8.0.json（少了个 /，变成 composerp2），直接 404。
实操建议：
- 所有镜像 URL 必须以
/结尾，这是 Composer 拼接p2/xxx/yyy.json路径时的硬编码逻辑 - 配置时务必核对：用
composer config --list | grep repo.packagist查看实际生效的 URL - 阿里云、腾讯云、中科大等主流镜像文档都明确要求带末尾斜杠，不是建议，是必须
强制刷新镜像源缓存的唯一可靠方式
没有“强制刷新镜像源”的命令。镜像源是服务端行为，客户端无权触发同步。所谓“刷新”，本质是让 Composer 重新下载元数据文件（packages.json、provider-*.json），并跳过本地缓存校验。
实操组合拳：
- 删掉项目根目录下的
composer.lock（它记录的是旧元数据快照，不删就永远不查新） - 运行
composer clear-cache（清掉本地~/.composer/cache，避免旧 JSON 被复用） - 执行
composer update --no-install或composer install（触发新一轮元数据拉取） - 若仍卡住，临时绕过镜像调试：
composer install -d repo.packagist=composer https://repo.packagist.org/
最常被忽略的点：改完镜像后，composer.lock 不删，等于没改——它锁死的是上次解析时看到的 provider 数据，和当前镜像无关。
