根本原因是配置结构不合法：必须同时满足键名repo.packagist、显式composer类型值、url以/结尾，缺一即静默回退官方源；验证需输出完整json对象如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
根本原因不是网络慢，而是配置结构不合法：Composer 2.x 要求 repo.packagist 必须是完整对象，不能只写 URL 字符串。漏掉 type 或 URL 缺尾部 /，就会静默 fallback 到 https://packagist.org，不报错也不提示。
常见错误写法：
-
composer config -g repo.packagist https://mirrors.aliyun.com/composer/—— 缺composertype 值，结构非法，部分版本直接丢弃 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer—— URL 少/，请求变成/composerpackages.json，返回 404 后自动切回官方源 -
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/—— 键名多一个s，完全不识别
验证是否真生效，只看这一条命令输出：
composer config -g repo.packagist 必须返回完整 JSON 对象，形如：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。如果返回空、null、"https://packagist.org" 或纯字符串，说明没配对。
项目级配置比全局更可靠，但 repositories 结构必须手动处理
全局配置写在 ~/.config/composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），但 CI 流水线、Docker 容器、宝塔面板等环境常以不同用户身份运行，根本读不到你的全局配置。
项目级配置直接写进 composer.json，拉代码即生效，推荐优先使用。执行命令（不加 -g）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
但它不会“添加”，而是按当前 repositories 字段结构做不同处理：
- 如果
"repositories": {}（空对象），会安全写入"packagist"子项 - 如果
"repositories": []（数组），该命令会直接覆盖整个字段，导致已有的私有 Git 源丢失 - 如果
"repositories": {"my-private": {}}（已有对象），会 merge 进去，保留原有内容
更重要的是：光配 packagist 不够，必须显式禁用默认源，否则 Composer 仍会先尝试 packagist.org，卡在 “Loading composer repositories” 或报 404。需确保 composer.json 的 repositories 对象里有："packagist.org": false，且与 "packagist" 同级。
为什么 composer install 还卡在 0 B/s
换镜像后仍卡住，大概率是没禁用默认源，或者 composer.lock 里还存着旧源的包地址。Composer 会先查 lock 文件里的 dist URLs，若仍是 packagist.org 域名，就直接走原路径下载 ZIP 包，镜像配置对这部分无效。
解决步骤：
- 确认
composer.json中repositories已含"packagist.org": false - 运行
composer update --lock强制重生成 lock 文件，把所有 dist URL 刷成镜像站地址 - 清除本地缓存：
composer clear-cache - 加
-vvv看真实请求地址：composer -vvv install，检查是否出现mirrors.aliyun.com
注意：阿里云镜像站本身不托管 ZIP 包，dist 文件仍从 GitHub / GitLab 等原始地址下载，所以还要确保这些站点在国内可直连；若不可达，需额外配置 github-protocols 或启用 dist 代理。
多个镜像源共存时的 fallback 行为
Composer 不支持“主备自动切换”。如果你在 repositories 里同时写了阿里云和官方源，它不会优先用阿里云失败再切官方，而是按顺序遍历所有源查找包元数据——一旦某个源返回 404 或超时，就直接报错，不会继续试下一个。
真正能 fallback 的只有两种情况：
- 你手动在
composer.json里定义多个type: "composer"源，并确保它们都包含完整包索引（极少见） - 使用
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/+"packagist.org": false组合，这是唯一受控的单点镜像方案
想实现兜底逻辑，得靠运维层：比如在公司内网部署 Nginx 反向代理，上游设两个 upstream（阿里云 + 官方），超时后自动 failover。Composer 本身不处理这个。
