Composer 不支持自动故障切换，仅依赖手动配置或外部脚本；全局镜像配置易因键名错误、缺参数、URL末尾无斜杠或项目级 repositories 存在而静默失效；需通过 config、diagnose、-vvv 日志三处验证实际生效源，并优先使用 --repository-url 临时指定。
Composer 本身不处理源不可用，也不做任何自动切换 —— 它只会死磕当前生效的那个源，直到超时、重试失败或报错退出。 所谓“故障切换”，全靠你手动干预或外部脚本兜底，不是 Composer 自己的功能。
composer config -g repo.packagist 为什么总不生效
它不是“有时失效”，而是只要写错三处中的任意一个，就静默失败、毫无提示：
-
repo.packagist键名写成repos.packagist（多一个 s）或packagist.org—— Composer 2.x 只认单数repo.packagist - 漏掉中间的
composer类型参数：正确命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，少掉composer就 fallback 到官方源 -
url末尾没加/：比如写成https://mirrors.aliyun.com/composer，实际请求会变成https://mirrors.aliyun.com/composerpackages.json，直接 404
更隐蔽的是：只要项目根目录 composer.json 里有 "repositories" 字段（哪怕空数组 [] 或 {}），全局配置就彻底被屏蔽，连 fallback 都没机会触发。
怎么确认镜像源真正在用
别信 composer config 的输出，它只告诉你“配了什么”，不告诉你“用了什么”。必须核对三处：
- 查配置：
composer config -g repo.packagist输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.ustc.edu.cn/composer/"} - 看诊断：
composer diagnose输出中 “Repo:” 行的域名，必须和你配的镜像一致 - 抓真实请求：
composer update -vvv日志里所有Downloading行的 URL，应含你设的镜像域名（如mirrors.huaweicloud.com）；或者composer show -p | head -3第一行显示的源地址
漏执行 composer clear-cache 是高频失误 —— 旧缓存里的 packages.json 还指向 repo.packagist.org，请求照发，根本不会走新镜像。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
临时切源比永久配置更可靠
尤其在 CI、调试、或帮别人跑命令时，硬改全局配置容易污染环境、难追溯问题。推荐这些方式：
- 单次命令强制走某源：
composer install -vvv --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/ - 仅当前项目生效（不写进
composer.json）：composer config repo.packagist composer https://mirrors.tencent.com/composer/ - CI 中用环境变量控制（避免依赖配置文件）：
COMPOSER_REPO_PACKAGIST=https://mirrors.cloud.tencent.com/composer/ composer install
注意：COMPOSER_REPO_PACKAGIST 在新版 Composer 中基本不被识别，别依赖它；--repository-url 是最干净、最可控的方式，绕过所有配置层，直指目标。
repositories 数组里不能塞多个 packagist 镜像
你在 composer.json 的 "repositories" 里写两个 {"type": "composer", "url": "..."}，Composer 会直接报 Invalid repository type —— 因为 packagist 被视为全局唯一源，重复声明同类型就拒绝加载。
所谓“多镜像配置”其实是误读。真正能起作用的只有：
- 一个
repo.packagist（全局或项目级） - 其他非 packagist 类型仓库（如私有 Satis、VCS、package）可并存，但它们不参与 fallback
-
"canonical": true只影响包搜索顺序，不是故障转移开关
复杂点在于：Composer 不暴露“当前源是否响应”的状态，也没回调机制。一旦出问题，你得自己用 curl -I 探活、脚本判断、再决定是否换源 —— 这才是故障切换的真实成本。
