华为云镜像配置必须执行composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/，三要素缺一不可：键名repo.packagist（非repos）、type值为composer、url末尾带斜杠；验证需输出完整json对象，空或报错即失败；同步有5–30分钟延迟，新包未同步时可临时切阿里云镜像；还需启用并加固缓存、配合--prefer-dist --no-dev --optimize-autoloader等参数才能真正提速。
华为云镜像地址必须带末尾斜杠且显式声明 type
直接执行 composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/ 才生效；漏掉末尾 /、写成 repos.packagist（多一个 s）、或省略 composer 类型值，都会导致配置静默失败。验证方式是运行 composer config -g repo.packagist，输出必须为完整 JSON 对象，例如 {"type": "composer", "url": "https://repo.huaweicloud.com/repository/php/"}。空、null 或报错说明没写进去。
华为云镜像同步有延迟，新包可能 5–30 分钟后才可用
若 composer install 报类似 The "https://repo.huaweicloud.com/repository/php/p2/vendor/package/1.2.3.json" file could not be downloaded (HTTP/2 404) 的错误，大概率不是你配错了，而是该包刚在 Packagist 发布，华为云镜像尚未同步。此时可临时切回阿里云镜像（同步更快）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，或等十几分钟重试。不建议手动删 lock 文件硬解——会破坏依赖一致性。
仅换镜像不够，必须配对启用本地缓存
华为云镜像只是把网络请求从海外搬到国内，但若缓存路径未启用或不可写，每次仍要重新下载 ZIP 包。确认并加固缓存：
- 运行
composer config -g cache-files-dir，非空且路径可写才算有效 - 若为空，补上：
composer config -g cache-files-dir ~/.composer/cache/files - 设缓存有效期防误用：
composer config -g cache-files-ttl 3600 - CI 环境（如 GitHub Actions）中，必须同时缓存
~/.composer/cache和vendor/目录结构，否则 PHP 版本微调就会触发全量重装
生产构建必须加 --prefer-dist --no-dev --optimize-autoloader
华为云镜像解决的是“拉得到”，这三个参数解决的是“拉得少、解得快、载得轻”：
-
--prefer-dist：强制走 ZIP 包，跳过所有git clone操作（实测比 source 快 2–5 倍） -
--no-dev：Laravel 生产环境完全不需要phpunit、laravel/pint等，少下 20+ 个包 -
--optimize-autoloader：生成静态 classmap，减少运行时文件扫描，autoload 阶段提速 30%+
完整命令：composer install --no-interaction --prefer-dist --no-dev --optimize-autoloader。Docker 构建中漏掉任一参数，都可能让构建时间从秒级回到分钟级。
华为云镜像本身稳定，但它的加速效果高度依赖缓存路径是否真实生效、PHP 版本与 platform 配置是否和 lock 文件一致、以及是否混用了项目级 repositories 配置——这些细节不检查，换再快的镜像也白搭。
