华为云服务器上composer install卡顿，首要确认镜像地址是否为https://mirrors.huaweicloud.com/repository/php/composer/（含/repository/php/composer/且末尾带/），键名必须是repo.packagist、type必须显式设为composer、需开启并发下载（composer config -g parallel-downloads 8），并排除项目级repositories覆盖及同步延迟影响。
华为云服务器上 composer install 还卡？先确认镜像地址是否写对
华为云镜像不是 https://mirrors.huaweicloud.com/composer/，也不是 https://repo.huaweicloud.com/composer/——正确地址是：https://mirrors.huaweicloud.com/repository/php/composer/（注意路径含 /repository/php/composer/，且末尾必须带 /）。
常见错误包括：
- 漏掉末尾
/，导致部分 Composer 版本返回 404 或解析失败 - 把
repo.packagist错写成repos.packagist（多一个s），配置静默失效 - 省略
composer类型标识，命令变成composer config -g repo.packagist https://...，结果被当成 vcs 源处理
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/composer/"}。空、null 或报错说明没写进去。
全局配置被项目级 repositories 覆盖了怎么办
华为云服务器上跑 CI/CD 或多人协作时，composer.json 里只要出现 "repositories" 字段，哪怕内容为空（"repositories": {}），全局镜像也会被忽略。
安全写法是显式声明 packagist 子源：
{
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.huaweicloud.com/repository/php/composer/"
}
}
}
注意三点：
-
"packagist"是固定 key 名，不能改成"huawei"或其他名字 - 该字段必须在
composer.json顶层，不能嵌套在require或其他位置 - 提交到 Git 时保留它——否则队友或 CI 流水线拉代码后走默认源，
composer.lock的 hash 可能不一致
并发下载没开，换再快的镜像也白搭
Composer 2.2+ 默认只开 3 个并发线程下载，相当于把千兆带宽压成百兆体验。华为云服务器通常带宽充足，不启用并发就是浪费资源。
执行这条命令开启并行：
composer config -g parallel-downloads 8
为什么是 8？
- 小于 5：提速不明显
- 大于 12：可能触发华为云镜像服务端限流，反而变慢
- 8 是实测在多数 ECS 实例（尤其是 2C4G 及以上）下的平衡点
验证是否生效：composer config -g parallel-downloads 应输出 8。
新包 404？别急着重配，先等同步延迟
华为云镜像同步有 5–30 分钟延迟。如果 composer install 报类似 The "https://mirrors.huaweicloud.com/repository/php/p2/vendor/package/1.2.3.json" file could not be downloaded (HTTP/2 404)，大概率不是你配错了，而是该包刚发布，镜像还没抓取过来。
临时解法（不用动配置）：
- 等 10–15 分钟重试
- 切阿里云镜像应急：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 避免手动删
composer.lock或vendor强行重装——会破坏依赖一致性
真正容易被忽略的是：镜像只加速「下载」，不解决「依赖解析」本身慢的问题。如果 composer install 卡在 Resolving dependencies 阶段，和镜像无关，得回头检查 composer.json 里的 PHP 版本约束、dev 包数量或 lock 文件是否损坏。
