当主仓库无法访问时，Composer可通过配置多个仓库实现依赖安装的高可用。在composer.json中按优先级定义repositories，如先私有仓库后packagist.org，Composer会依次尝试获取包，前一个返回404或连接失败则自动 fallback 到下一个；还可为packagist配置镜像源增强可靠性，如使用packagist.jp作为备用。关键原则是专用仓库前置、通用源后置，避免版本冲突，确保HTTPS安全及网络可达性，从而保障CI/CD流程稳定。
当主仓库无法访问时，为 Composer 设置备用仓库能确保依赖包的安装流程不中断。你可以通过配置多个仓库，并将它们按优先级排列来实现失败重试的效果。Composer 会依次尝试这些仓库，直到找到所需包为止。
理解 Composer 的仓库机制
Composer 使用 repositories 配置项定义包的来源。默认情况下，它从 packagist.org 获取公开包。你可以在项目或全局的 composer.json 中添加额外的仓库。如果某个仓库返回 404 或连接失败，Composer 会继续尝试下一个匹配的仓库（前提是该包在其他仓库中存在）。
注意：只有当你显式声明了自定义仓库，且未包含所需包时，Composer 才会跳过并尝试后续仓库。因此，要实现“fallback”效果，应将最具体的仓库放在前面，通用的放后面。
配置多个仓库实现 fallback
在项目的 composer.json 中添加多个 repositories 条目，顺序很重要。例如：
{
"repositories": [
{
"type": "composer",
"url": "https://private-repo.example.com"
},
{
"type": "composer",
"url": "https://packagist.org"
}
],
"require": {
"monolog/monolog": "^2.0",
"your/private-package": "^1.0"
}
}
在这个例子中：
- Composer 先尝试从私有仓库获取所有包。
- 如果私有仓库返回 404（表示没有这个包），Composer 会自动转向 packagist.org。
- 如果私有仓库无法连接（超时或 5xx 错误），Composer 也会尝试下一个。
这种机制天然支持“fallback”行为，无需额外插件。
使用镜像作为更可靠的 fallback
除了添加多个独立仓库，你还可以为 packagist 配置镜像，设置主镜像失败后自动切换到备用镜像：
composer config --global repos.packagist composer https://packagist.org composer config --global repo.packagist-mirror composer https://packagist.jp
或者手动写入全局配置（~/.composer/config.json）：
{
"repositories": {
"packagist.org": {
"type": "composer",
"url": "https://packagist.org"
},
"packagist-mirror": {
"type": "composer",
"url": "https://packagist.jp"
}
}
}
Composer 会自动选择可用的 packagist 源。某些镜像服务（如 Packagist.jp）本身就是 packagist.org 的同步副本，适合用作灾备。
注意事项与最佳实践
为了确保 fallback 机制有效，请注意以下几点：
- 私有包必须只出现在私有仓库中，否则可能导致权限错误或版本混乱。
- 避免在多个仓库中发布相同版本的不同内容，这会破坏一致性。
- 使用 HTTPS 确保传输安全。
- 定期测试仓库连通性，特别是在 CI/CD 环境中。
基本上就这些。Composer 原生支持多仓库 fallback，合理配置即可实现高可用的依赖拉取。关键是把专用仓库放前，通用源放后，并确保网络可达性。
