根本原因是插件（如hirak/prestissimo）绕过composer原生http客户端，直接调用系统curl/wget直连github，不读取repo.packagist配置，导致镜像失效；应禁用插件（--no-plugins）并卸载废弃插件。
为什么某些插件包（如hirak/prestissimo）在镜像下会报错
不是镜像本身有问题，而是这类插件本身会接管 Composer 的下载逻辑——它们绕过 Composer 原生的 HTTP 客户端，直接调用系统 curl 或 wget，且不读取 repo.packagist 配置。结果就是：你配了阿里云镜像，它仍直连 github.com 或 api.github.com，被墙或限速后立刻失败。
典型错误包括：[RuntimeException] The "https://api.github.com/repos/hirak/prestissimo/zipball/..." file could not be downloaded，或者卡在 downloading provider-*.json 后无响应。
- 这类插件多用于加速（如
hirak/prestissimo、composer/installers早期版本），但与现代 Composer 2.x 的并发机制冲突 - 镜像站只代理
packages.json和 dist ZIP 包，不代理 GitHub API 请求 - 一旦插件在
composer install初期就被加载（比如通过plugins字段或全局启用），它就会在镜像生效前就发起直连请求
遇到插件包下载失败，先停掉插件再重试
别急着换镜像或调超时——插件才是当前阻塞点。最有效动作是临时禁用所有插件，让 Composer 回归原生逻辑走镜像通道。
- 加
--no-plugins参数强制跳过插件加载：composer install --no-plugins --prefer-dist - 如果已安装过插件且缓存损坏，先清缓存：
composer clear-cache，再删vendor目录 - CI 环境或脚本中务必显式带上
--no-plugins，避免因旧版插件引发并发崩溃 - 确认是否全局启用了插件：运行
composer config -g plugins，若输出true，可临时关闭：composer config -g plugins false
哪些插件必须移除才能用镜像
以下插件与镜像源存在根本性兼容问题，2026 年起已基本被 Composer 原生能力替代，继续保留只会增加失败概率：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
hirak/prestissimo：Composer 2.2+ 内置并行下载，该包已废弃，卸载命令：composer global remove hirak/prestissimo -
composer/composer（非官方）：手动替换核心二进制文件，极易与镜像元数据解析冲突 - 任何声明了
"type": "composer-plugin"且修改了Downloader类的私有插件 - 老版本
composer/installers（download 方法硬编码 GitHub URL，不尊重镜像配置
验证方式：删掉插件后，运行 composer require monolog/monolog --no-install -vvv，观察日志里 Downloading https://mirrors.aliyun.com/composer/... 是否出现。
镜像配置正确但插件仍失败？检查 repositories 优先级
即使全局镜像设对了，只要项目 composer.json 里写了 "repositories" 字段，Composer 就会优先用它——而很多团队模板里会把插件包单独指向 GitHub，彻底绕过镜像。
- 运行
composer config repo.packagist（不带-g），看输出是否仍是镜像地址；如果是packagist.org，说明被项目级配置覆盖 - 搜索
composer.json中的"repositories"块，重点关注是否包含类似"url": "https://github.com/xxx/yyy.git"的 VCS 源 - 临时注释掉整个
"repositories"段，再试composer install --no-plugins；若成功，说明问题出在私有源配置上
真正容易被忽略的点：镜像只管 packagist.org 域名下的包，对 github.com、gitlab.com 等 VCS 源完全无效。插件若依赖 Git 源，就得另配 SSH、Token 或改用 dist 发布。
