Composer 无运行时镜像容灾切换能力，真正的容灾需外部探测+动态换源+清缓存三步原子操作；clear-cache仅清本地缓存不重载源配置，失败即报错不自动换源；多源配置需正确设置repositories.packagist.org键名并关闭默认源。
Composer 没有运行时镜像容灾切换能力，所谓“缓存失效自动 fallback”是误解；真正的容灾必须靠外部探测 + 动态换源 + 清缓存三步原子操作，缺一不可。
为什么 composer clear-cache 后还连不上镜像
清缓存只清 ~/.composer/cache 里的 ZIP 和元数据快照，但不会重载 config.json 中的源配置——如果该镜像 URL 已返回 502/超时，Composer 会直接报错退出，根本不会查第二个源。
常见错误现象：Failed to download https://mirrors.aliyun.com/composer/packages.json: The "https://mirrors.aliyun.com/composer/" file could not be downloaded (HTTP/2 0)，后续无任何换源提示。
根本原因：Composer 把 repositories 数组当静态元数据合并表，不是运行时路由表；它只在解析阶段请求一次每个源的 packages.json，失败即终止。
- 超时、5xx、DNS 失败 → 直接报错，不尝试下一个源
- 仅当第一个源对某个包明确返回 404（HTTP 404 + JSON body）→ 才查第二个源是否声明了该包
- 镜像同步延迟导致的“找不到包”，不是配置问题，而是
packages.json根索引未及时更新
全局镜像优先级怎么设才真正生效
Composer ≥2.2 必须用 repositories.packagist.org 键名，repo.packagist 在新版中会被静默忽略；且该字段是单值，多次执行 composer config -g repositories.packagist.org 只会覆盖，不会叠加。
正确写法示例：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
注意：url 必须以 https:// 开头、结尾带 /，否则 Composer 2.5+ 会报 Invalid repository type。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 验证是否生效：
composer config -g repositories.packagist.org应输出完整 JSON 对象 - 若输出为空或仍是官方地址，说明键名错误或权限写入失败（如之前用
sudo写错位置） - Windows 下 Git Bash 用户要注意：
COMPOSER_HOME可能未生效，实际读取的是%APPDATA%\Composer\config.json
项目级 repositories 覆盖全局配置的陷阱
只要项目 composer.json 里定义了 repositories 字段（哪怕为空数组），全局配置就彻底失效——Composer 不合并，只替换。
典型症状：运行 composer config --list 显示 repositories 为空或只有默认项，而 composer config --list --global 却显示已配镜像。
此时 composer install 仍直连 packagist.org，因为项目级配置已接管全部行为。
- 项目级
repositories数组顺序 = 实际匹配顺序：从上到下逐个请求packages.json - 第一个返回 HTTP 200 + 结构正确 JSON 的源即锁定使用，其余全跳过
- 想启用多镜像兜底，必须手动加
"packagist.org": false关闭默认源，并在末尾加{"type": "packagist", "packagist": true}做元数据兜底（注意不是"packagist": {"type": "composer", "url": "..."}）
生产环境可用的镜像容灾脚本关键点
真容灾不是靠 Composer 自身，而是靠 shell 脚本封装探测 + 切源 + 清缓存。核心是三步原子操作，任意一步失败都会导致切换无效。
推荐探测方式：curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json，只认 200，其他一律视为不可用。
切换命令必须用 composer config -g repositories.packagist.org，且切换后立即执行 composer clear-cache，否则旧镜像元数据残留会导致后续 404。
- CI 流水线建议用腾讯云镜像：
https://mirrors.cloud.tencent.com/composer/，其默认开启回源逻辑，对新包同步延迟更友好 - 避免用
composer global require管理切换工具——引入 PHP 运行时依赖，且COMPOSER_HOME环境变量易污染 - 临时切源场景（如调试）优先用
-d参数指定项目路径 +COMPOSER_HOME临时隔离，不落盘、不持久
最常被忽略的点：镜像 URL 末尾的 /、键名版本兼容性、以及 clear-cache 是否真的执行成功——这三者任一缺失，都会让容灾脚本形同虚设。
