Composer不支持自动故障转移，需显式禁用默认源并配置显式仓库顺序：将阿里云镜像置前、官方源置后，并在根节点设"packagist.org": false。
Composer 无法在包加载失败时自动切换备用镜像——它不支持故障转移、健康检查或超时 fallback。所谓“优先级”只是线性扫描 repositories 数组，仅当首个源明确返回 HTTP 404（包不存在）时才尝试下一个；遇到超时、500、DNS 失败等，直接报错退出，根本不会查第二个源。
为什么改了 repositories 顺序却没走镜像？
最常见原因是没禁用隐式兜底源 packagist.org。哪怕你把阿里云镜像写在第一位，只要它对某个包返回 404，Composer 就立刻切到官方源，看起来像“优先级失效”，其实是默认行为被触发了。
- 运行
composer config repositories查看当前实际生效的源列表和顺序，别靠猜 - 确认项目根目录
composer.json中是否也定义了repositories：有则优先生效，全局配置（~/.composer/config.json）完全被忽略 - 必须显式加上
{"packagist.org": false}，且放在repositories数组末尾（不是开头），否则官方源仍会偷偷发起请求 - 删掉
vendor和composer.lock后重跑composer install，避免旧 lock 文件记录的是官方源 hash
怎么写 repositories 才让阿里云 + 官方源协同工作？
核心是关闭默认源，把镜像和官方源都列为显式仓库，并靠顺序控制优先级。以下是最简可用配置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
},
{
"type": "composer",
"url": "https://packagist.org/"
}
],
"packagist.org": false
}
-
"packagist.org": false必须写在根节点，不是repositories里；漏掉这句，你的镜像只是「锦上添花」，不是「替代方案」 - 两个源都用
"type": "composer"，别写成artifact或package，否则无法查包列表 - 阿里云镜像响应快但偶尔滞后几小时，官方源永远最新但慢；把阿里云放前面，能覆盖 99% 场景，真遇到新包再 fallback 到官方源
- 如果项目依赖私有 Git 包（
"type": "vcs"），它们不受repositories顺序影响，仍走各自定义的 URL
想“模拟 fallback”，只能靠外部脚本检测可用性
Composer 自身做不到，但你可以用 shell 脚本临时切换：
- 先检测镜像是否存活：
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json返回200才设为当前源 - 动态执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 切换后务必运行
composer clear-cache，否则旧镜像的元数据可能残留导致 404 - CI/CD 中更推荐用环境变量临时指定：
COMPOSER_REPO_PACKAGIST=https://mirrors.tuna.tsinghua.edu.cn/composer/ composer install
真正容易被忽略的是：镜像同步有延迟，packages.json 根索引更新不及时会导致新包查不到；而 "packagist": true 这种兜底写法虽能缓解，但会让 ZIP 包也回退到官方源下载，失去镜像加速意义。所以生产环境建议只配一个主力镜像 + {"packagist.org": false}，堆砌多个源不提升可用性，反而增加不可控延迟。
