composer多镜像源不支持自动fallback，仅按repositories数组顺序线性查找：首个返回http 200+有效json的源即被锁定使用，后续全跳过；仅404触发下一源尝试，超时、500等错误直接报错退出；必须显式配置"packagist.org": false并置于数组末尾，且项目级配置优先于全局配置。
Composer多镜像源不支持自动fallback，只按数组顺序线性查找
Composer根本不存在“优先级调度算法”——它没有健康检查、超时重试或轮询机制。所谓“优先级”，就是repositories数组里元素的书写顺序：从上到下依次尝试，第一个返回有效包元数据（HTTP 200 + 可解析JSON）的源就锁定使用，后面的全跳过。
常见错误是以为加了阿里云、腾讯云、官方源三个URL就能“自动选最快的”，结果发现永远只走第一个。这不是配置问题，而是设计如此：Composer只在遇到404时才继续查下一个；遇到timeout、500、DNS failed等，直接报错退出，根本不会触发“切换”。
- 把响应最快、同步最及时的镜像（如
https://mirrors.aliyun.com/composer/）放在repositories第一位 - 备用镜像（如腾讯云）可放第二位，但仅当第一位明确返回
404时才启用——不是“连不上就切”，而是“包不存在才查下一个” - 绝对不要同时写
https://repo.packagist.org/和镜像URL：前者会抢在镜像前发请求，失败即中断，镜像根本没机会响应
packagist.org默认隐式兜底，必须显式禁用才能让镜像真正生效
哪怕你在repositories数组里把阿里云镜像写在第一位，只要没禁用packagist.org，Composer仍会把它当作最高优先级源——不是靠数组位置，而是靠内置逻辑。一旦镜像对某个包返回404（比如新包尚未同步），Composer立刻切回官方源，看起来像“优先级失效”，其实是兜底行为在起作用。
验证是否真禁用了：composer config repositories输出中，"packagist.org": false必须存在，且url字段只出现你的镜像地址，不能有repo.packagist.org。
-
"packagist.org": false必须作为独立对象写入repositories数组，且放在末尾（不是开头） - 项目级配置优先生效：如果
composer.json里定义了repositories，全局配置（~/.composer/config.json）完全被忽略 - 删掉
vendor和composer.lock再执行composer install，否则lock文件里记录的仍是旧源hash，换镜像也无效
多个镜像共存时，元数据与dist包可能分属不同源
国内镜像本质是packagist.org的只读代理，只同步元数据索引（packages.json）和ZIP包（dist），但不托管完整元数据快照。新包发布后，镜像同步有延迟（通常几分钟），期间packages.json根索引未更新，就会导致Could not find package——浏览器能打开子路径/p2/xxx/xxx.json，但Composer第一步请求/packages.json就失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
解决方案不是堆砌更多镜像，而是补一个元数据兜底项："packagist": true（注意不是"packagist.org"）。它会让Composer回退到官方源拉取元数据，但ZIP包仍从你配置的第一个镜像下载（只要该镜像有）。
- 在
repositories数组末尾加{"packagist": true}，而非{"type": "composer", "url": "https://packagist.org/"} - 私有仓库混用时，把私有源放在
repositories最前面，确保同名包优先匹配私有源 - 避免私有包名与Packagist上已有包冲突，Composer不按版本路由，只按包名查源
生产环境别堆砌多个镜像，主备切换必须靠外部脚本控制
把阿里云、腾讯云、华为云三个镜像全塞进repositories，不仅不能提升可用性，反而增加不可控延迟：Composer会逐个尝试，每个都等30秒超时，最终耗时翻倍。真实高可用方案从来不是靠Composer自身配置，而是由CI/CD脚本或部署工具完成探测+切换。
典型做法是用curl检测镜像根路径可用性：curl -sI https://mirrors.aliyun.com/composer/ | head -n1 | grep "200 OK"，成功则设为当前源，失败则切到备用，并清空缓存。
- 执行
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/覆盖全局源（注意key是repos.packagist，不是repo.packagist） - 切换后必须运行
composer clear-cache，否则DNS缓存、HTTP连接池可能残留旧行为 - CI中建议用
actions/cache分开缓存不同镜像下的vendor，避免混用导致依赖解析错乱
复杂点在于元数据同步延迟和缓存残留，这两处最容易被忽略，也是线上故障最常见的根源。
