Composer不支持自动镜像切换，因无fallback机制；重复配置同类型镜像源会报错；主备切换需依赖外部脚本或环境变量控制，如用curl探测后通过composer_repo_packagist动态设置。
为什么composer config -g repo.packagist设两次没用
因为 repo.packagist 是单值字段，第二次执行会直接覆盖第一次——不是“追加”，是“替换”。你看到的配置始终只生效最后一个 URL。常见误操作是先设阿里云，再设腾讯云，结果只剩腾讯云；或者误写成 repos.packagist（Composer ≥2.0 已废弃），导致配置静默失败。
验证是否真写进去了：composer config -g -l | grep repo.packagist，输出应为类似：repos.packagist {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
- 别手写
~/.composer/config.json，格式错、逗号漏、引号不闭合都会让 Composer 忽略整个配置 - 若输出为空或仍是
packagist.org，说明命令根本没跑成功，或被权限/路径问题拦截 - Windows 用户注意：PowerShell 里 URL 中的
:和/可能被转义，建议换 CMD 或 Git Bash 执行
阿里云镜像该用 HTTPS 还是 HTTP 内网地址
取决于你在哪里运行 Composer。公网开发机、Mac/Linux 本地、非阿里云服务器，必须用 HTTPS：https://mirrors.aliyun.com/composer/；而阿里云 ECS（VPC 或经典网络）上跑 CI/CD 或部署脚本，应切到对应内网地址：
- VPC 网络用户：
http://mirrors.cloud.aliyuncs.com/composer/（无 HTTPS，但延迟常低于 10ms） - 经典网络用户：
http://mirrors.aliyuncs.com/composer/
这两个内网地址在阿里云机房外访问会直接失败，错误是 Connection refused 或卡在 Resolving dependencies。别图省事全项目统一配一个 URL——ECS 上用 HTTPS 不仅慢，还走公网流量计费。
项目级 repositories 覆盖全局镜像怎么办
这是最隐蔽的“镜像失效”原因：只要 composer.json 里写了 "repositories" 字段，Composer 就会完全忽略你配的 repo.packagist 全局设置。常见于老项目、Laravel 模板、或曾手动加过私有源的工程。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
检查方法：grep -A5 '"repositories"' composer.json。如果看到类似：
"repositories": [
{"type": "composer", "url": "https://packagist.org/"}
]
那就得删掉或注释掉整段——哪怕它只是重复了官方源，也会让全局镜像失效。
- 删完记得
composer clear-cache，否则install还可能沿用旧索引 - 如果项目确实需要额外源（比如公司私库），保留
repositories，但把阿里云镜像也加进去，并确保"packagist.org": false写在根节点 - 临时绕过所有配置验证镜像可用性：
composer require monolog/monolog -r https://mirrors.aliyun.com/composer/
如何让阿里云 + 官方源真正 fallback
Composer 本身不支持多镜像自动轮询，所谓“fallback”只能靠显式声明顺序 + 关闭默认源实现。关键不在堆 URL，而在结构和开关：
在项目 composer.json 根节点写：
{
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"type": "composer", "url": "https://packagist.org/"}
],
"packagist.org": false
}
-
"packagist.org": false必须是根字段，不能塞进repositories数组里，否则无效 - 阿里云放第一位，官方源仅在阿里云返回 404（包确实不存在）时才触发，不是连接超时就切
- 默认单源超时是 30 秒，卡住时看日志：
composer install -vvv，重点找Downloading https://...那行实际请求的域名 - 更稳的做法是加环境变量：
COMPOSER_IPV4=1强制走 IPv4，避免某些网络下 IPv6 握手拖死
真正影响稳定性的，从来不是镜像数量，而是你有没有关掉默认源、有没有强制 IPv4、有没有延长超时——这些细节比盲目加镜像 URL 管用得多。
