华为云Composer镜像配置失效主因是命令错误：键名必须为repo.packagist（非repos）、type值composer不可省略、URL须HTTPS且末尾带/，三者缺一即静默回退官方源；验证需输出完整JSON对象。
华为云 Composer 镜像能显著提速，但配错一个字符就完全失效——不是慢，是根本没走镜像。
composer config -g repo.packagist 命令为什么总不生效
这条命令本身没问题，但实际运行后 composer install 依然连 packagist.org，常见原因有：
-
repo.packagist写成repos.packagist（多一个s）——Composer 完全忽略，不报错也不提示 - 漏掉
composer这个 type 值，比如执行composer config -g repo.packagist https://...，会被当成 VCS 源处理 - 项目根目录已有
composer.json且含"repositories"字段，它优先级高于全局配置，直接覆盖 - 执行命令的用户和实际运行
composer的用户不一致（如用sudo配了 root 的全局配置，但开发时用的是普通用户） - 用了已失效的旧地址，例如
https://mirrors.huaweicloud.com/repository/php/或https://repo.huaweicloud.com/composer/，当前唯一稳定地址是https://repo.huaweicloud.com/repository/php/（注意末尾斜杠）
正确配置华为云镜像的三要素
必须同时满足以下三点，缺一不可：
- 键名必须是
repo.packagist，不能是repos.packagist、mirror或其他变体 - 中间的
composer是 type 值，不是可选参数，也不能省略或替换成composer.org - URL 必须是 HTTPS 协议，且末尾带
/：例如https://repo.huaweicloud.com/repository/php/✅，少斜杠会拼出/composerpackages.json导致 404 ❌
验证是否写入成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://repo.huaweicloud.com/repository/php/"}。空、null 或报错，说明没写进去。
项目级配置比全局更可靠
全局配置只在你当前终端用户下生效；而 CI/CD、Docker、宝塔等环境常以不同用户运行，~/.composer/config.json 根本读不到。项目级配置写进 composer.json，才是真落地：
- 进项目根目录，执行：
composer config repo.packagist composer https://repo.huaweicloud.com/repository/php/（不带-g） - 该命令会自动往
composer.json的"repositories"字段里加"packagist": {}，key 必须是packagist，不能改成huawei或其他名字 - 如果项目中已有
"repositories": []（数组格式），命令会失败；需先手动改成"repositories": {}（空对象）再运行 - 提交
composer.json到 Git，协作者拉代码即用，composer.lock生成逻辑一致，不会因源不同导致 hash 差异
换源后仍卡在 “Loading composer repositories” 怎么办
这不是镜像没生效，而是请求压根没发出去——大概率被缓存或配置覆盖了：
- 先运行
composer clear-cache，旧缓存里可能存着官方源的元数据，不清掉会继续尝试连接 - 删掉项目下的
vendor/和composer.lock - 加
-vvv重跑：composer install -vvv，看日志里Downloading的域名是不是repo.huaweicloud.com，而不是packagist.org - 检查
composer.json是否存在"packagist.org": false这类彻底关源的写法 - 运行
composer diag，重点关注Available repositories:行，应包含https://repo.huaweicloud.com/repository/php/且状态为packagist
真正容易被忽略的是：华为云镜像同步延迟通常在 5 分钟内，不是实时；但混用多个镜像源配置——只要有一个地方写错 URL 或 type，Composer 就会悄无声息地 fallback 到默认源。
