如何解决Composer更新依赖卡住及国内镜像配置故障？

本文共计903个文字，预计阅读时间需要4分钟。

使用Composer更新依赖时，如果遇到90%以上是镜像配置未生效或被覆盖的问题，通常不是由于网络本体问题造成的。以下是简短的解决方案：

composer config -g repo.packagist 是不是真在用国内镜像

很多人以为执行过 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 就万事大吉，其实这个设置可能被项目级配置、环境变量或 Composer 插件覆盖。

• 运行 composer config -g repo.packagist 确认全局配置值（注意末尾不能带斜杠，否则部分版本会 404）
• 进到项目目录后，再运行 composer config repo.packagist —— 如果有输出，说明项目级配置优先级更高，它会覆盖全局设置
• 检查是否存在 COMPOSER_REPO_PACKAGIST 环境变量：echo $COMPOSER_REPO_PACKAGIST，它比所有 config 都高

阿里云 / 清华镜像地址写法差异导致 404 或重定向失败

不同镜像源对路径和协议要求严格，写错一个字符就会让 Composer 卡在 HTTP 重定向或超时。