Composer 不支持自动 fallback 到备用源，必须靠外部脚本探测健康状态后手动重配；其 repositories 为单值字段，多镜像会报错，且无优先级或备用列表机制。
Composer 本身不支持自动 fallback 到备用源，所谓“自动切换”必须靠外部脚本主动探测 + 手动重配，否则卡在 Downloading 或报 Connection timed out 时它只会重试当前源，不会换地址。
为什么不能依赖 Composer 自带的 fallback 机制
Composer 的 repositories 是单值字段，不是数组；写多个同类型镜像（比如两个 composer 类型源）会直接触发 Invalid repository type 报错。官方文档从没提供“失败后自动切下一个”的能力——这功能得你自己补。
-
repo.packagist（单数）只接受一个 URL，无法声明优先级或备用列表 - 即使你在
composer.json里写了多个repositories，Composer 也只按顺序尝试，但一旦某个源返回 404 或超时，它不会继续往下试，而是直接报错或卡住 - 所谓“fallback 到 packagist.org”仅发生在你完全没配置
repo.packagist时，且缓存未污染；一旦设过镜像，删配置也不等于自动回退，尤其在 Composer 2.2–2.4 小版本中 fallback 逻辑有缺陷
CI/CD 中真正可用的自动切换方案
必须用 shell 脚本主动探测国内镜像健康状态，再写入有效配置。这不是可选优化，而是稳定交付的前提。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先运行
composer clear-cache，避免旧缓存干扰探测结果 - 按顺序
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json检查 HTTP 状态码，200 才算可用 - 依次试
https://mirrors.cloud.tencent.com/composer/packages.json、https://repo.huaweicloud.com/repository/php/packages.json - 首个返回 200 的源，用
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://.../"}'写入（注意：CI 环境推荐用repositories.packagist.org键名，兼容性比repo.packagist更稳） - Windows CI 需确认配置路径是
%APPDATA%\Composer\config.json，不是~/.composer/config.json
项目级临时切回官方源的可靠命令
不想动全局配置？进项目目录后执行这条命令，它会直接覆盖当前项目的 repo.packagist，且绕过所有 fallback 缺陷。
- 运行
composer config repo.packagist composer https://packagist.org（不加-g） - 必须显式带上
composer类型参数，不能省略 - URL 必须以
https://开头、末尾带/，否则请求路径拼接错误，导致 404 - 执行后立刻验证：
composer config repo.packagist应输出{"type": "composer", "url": "https://packagist.org/"} - 别忘了清缓存：
composer clear-cache，否则仍可能读到旧镜像的packages.json快照
最容易被忽略的覆盖点：项目 composer.json
哪怕你全局和当前项目都设好了官方源，只要 composer.json 里存在 "repositories" 字段，它就优先生效——这是设计，不是 bug。
- 检查方式：
composer config repo.packagist输出正常，但composer install -vvv日志里仍出现mirrors.aliyun.com？八成是composer.json里写了"repositories": [...] - 临时禁用：
composer config --unset repositories，或手动删掉整个"repositories": ...块 - 特别注意 Laravel 脚手架或私有模板生成的
composer.json，常硬编码"packagist.org": false，不改文件就永远绕不过去 - 环境变量也可能干扰：
env | grep COMPOSER_REPO（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows），有就 unset
真正起作用的从来不是“多写一个镜像”，而是清缓存、删冗余配置、验证真实请求域名这三步闭环。漏掉任意一环，都会让你以为切换成功了，其实还在连旧地址。
