composer不支持多镜像自动fallback，因repo.packagist为单值字段，后设url覆盖前设；真容灾需用脚本探测可用性、动态切换源并清缓存。
直接用 composer config -g repo.packagist 只能设一个主镜像源，想同时用阿里云、腾讯云、华为云等多源做 fallback 或按需切换，得绕过默认单源限制——本质是手动管理 repositories 数组，且必须禁用 packagist.org 自动代理。
为什么 repo.packagist 不能存多个？
Composer 2.x 硬编码只认 repo.packagist 这个单数键名，且只接受一个对象值。你写两次 composer config -g repo.packagist composer https://xxx，后一次会覆盖前一次；强行塞数组进去（比如 "repo.packagist": [{}, {}]）会导致解析失败，composer diagnose 报 Repo is not configured properly。
如何安全添加多个镜像源（如阿里云 + 腾讯云）？
必须改用 repos 键，并显式关闭默认源：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先禁用自动 packagist 映射：
composer config -g repos.packagist false - 再逐个加镜像：
composer config -g repos.aliyun composer https://mirrors.aliyun.com/composer/ - 再加第二个：
composer config -g repos.tencent composer https://mirrors.cloud.tencent.com/composer/ - 验证：
composer config -g repos应输出含"aliyun"和"tencent"的对象，每个都有"type": "composer"和带末尾/的 HTTPS URL
多源下 Composer 怎么选哪个下载？
它不自动 fallback，顺序决定优先级——composer config -g repos 输出的键名顺序就是实际查询顺序。但注意：
- Composer 不会“试错”：如果第一个源返回 404 或包不存在，不会自动切到第二个源
- 真正生效的是
composer.json里repositories字段的顺序，而composer config -g repos.xxx写入的是全局配置，最终会合并进composer.json的repositories（前提是项目没自己定义） - 若项目已有
"repositories": [...]数组，则全局repos配置会被忽略；此时必须手动编辑项目composer.json，把多个镜像按需排在数组开头
切多源后 composer.lock 还是旧地址怎么办？
和单镜像一样，composer.lock 里的 dist.url 仍指向原始源，多源配置本身不触发重写。必须组合执行：
-
composer clear-cache清掉旧元数据缓存 -
composer update --lock强制刷新所有包的dist.url，让它从当前生效的最高优先级镜像生成路径（例如https://mirrors.aliyun.com/composer/dists/...） - 验证：打开
composer.lock，搜"dist": {，看任意一个hyperf/*或monolog/monolog的url字段是否已变成你配置的镜像域名
最容易被跳过的其实是 --lock 刷新——多源配置写对了，composer config -g repos 输出也正常，但 composer install 还是从 packagist.org 拉包，八成是 composer.lock 没更新。
