composer镜像不生效的主因是repo.packagist键名写错（如repos.packagist）、漏掉type值composer、url末尾缺/，三者任一出错即静默回退官方源；验证需输出完整json对象。
Composer 下载慢，90% 不是网络问题，而是镜像根本没生效——repo.packagist 写成 repos.packagist、漏掉 composer 类型参数、URL 末尾少 /，三者任一出错都会静默 fallback 到 https://packagist.org，你还在等它超时。
为什么 composer config -g repo.packagist 总不生效
这条命令不报错，但实际配置被忽略，常见原因就三个：
-
repo.packagist键名写成了repos.packagist（多一个s）——Composer 2.x+ 直接跳过，不提示也不警告 - 命令里漏了
composer这个 type 参数：composer config -g repo.packagist https://mirrors.aliyun.com/composer/是错的；必须写成composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 末尾没加
/：比如https://mirrors.aliyun.com/composer❌，会拼出/composerpackages.json导致 404；正确是https://mirrors.aliyun.com/composer/✅
验证是否真写进去了：运行 composer config -g repo.packagist。输出必须是完整 URL 字符串或类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的 JSON。如果为空、null 或仍是 https://packagist.org，说明压根没写成功。
项目级配置比全局更可靠
在 CI、宝塔、Docker 或团队协作中，全局配置（-g）极易因用户权限错位而失效——比如你在终端用 root 配了，但构建脚本以 www-data 或 runner 用户运行，根本读不到 /root/.composer/config.json。
更稳的做法是进项目根目录后执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令不加 -g，会自动向当前项目的 composer.json 的 repositories 字段追加条目，不会覆盖已有私有源。改完后务必跑一次：
composer update --lock
否则 composer.lock 里仍存着旧的 dist.url，下载时先试境外地址，失败才 fallback，卡顿照旧。
换源后还是卡在 Downloading？先看日志再动手
光靠 composer config 输出判断是否生效不可靠。唯一可信的方式是加 -vvv 看真实 HTTP 请求：
composer install -vvv 2>&1 | grep "Downloading"
观察输出里是否命中你配的域名，比如 mirrors.aliyun.com。如果还看到 packagist.org，说明：
- 缓存没清：
composer clear-cache必须紧跟换源操作之后执行，否则 Composer 优先读旧缓存里的元数据 - 项目级
repositories覆盖了全局配置（哪怕只写了"repositories": {}也会屏蔽） - CI 或容器里用了插件（如过时的
hirak/prestissimo），反而干扰原生并发逻辑
临时绕过所有自定义源测试：运行 composer install --no-plugins --repository=https://packagist.org -vvv，如果这时快了，就是项目配置或插件在作祟。
Resolving dependencies 卡住和镜像无关
镜像只加速下载环节（Downloading、Fetching package），不解决依赖解析阶段的卡顿。如果你发现 composer update 卡在 Resolving dependencies 超过 10 秒，大概率是本地求解器在穷举版本组合，和网络完全无关：
- PHP 内存不足：默认 128M 不够，临时加
COMPOSER_MEMORY_LIMIT=-1 - Xdebug 开着：运行
php -v看是否含xdebug，它会让解析慢 5–10 倍；禁用方式：php -d xdebug.mode=off $(which composer) install -
config.platform.php和实际 PHP 版本不匹配（如设为"7.4"却在 PHP 8.5 上运行），触发降级查找逻辑 - 约束太宽：
"*"、"^1.0 || ^2.0"或"minimum-stability": "dev"容易引发组合爆炸
这类问题无论换哪个镜像都无解，得调本地环境或收紧依赖约束。
