运行 composer config -g repo.packagist 应输出完整 JSON 对象如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null 或显示 https://packagist.org 均说明配置未生效；必须同时验证 composer install -vvv | grep mirrors 和 ~/.composer/config.json 文件内容，三者一致才确认镜像真正启用。
运行 composer config -g repo.packagist 看输出地址
这是最直接的验证方式。执行后应明确返回你设的镜像地址，比如 https://mirrors.aliyun.com/composer/ 或 https://mirrors.cloud.tencent.com/composer/。注意末尾必须带斜杠，否则部分 Composer 版本会静默忽略该配置，仍走 packagist.org。
常见错误现象：composer config -g repo.packagist 返回空、报错“Key 'repo.packagist' does not exist”，或输出原始 https://packagist.org ——说明配置根本没写进去，或写到了错误用户家目录（如 Ansible 下以 root 写入但 PHP 进程用 www-data 身份运行）。
执行 composer install -vvv 2>&1 | grep "mirrors." 捕获真实请求域名
配置可能“存在”，但不一定“生效”。composer install 实际下载时是否走镜像，才是最终判据。
实操建议：
- 先清缓存：
composer clear-cache，避免旧包仍从本地 cache 加载而绕过网络验证 - 确保项目有
composer.json且含至少一个非本地依赖（如"monolog/monolog": "^3.0"） - 加
-vvv启动详细日志，用grep过滤域名关键词，看到mirrors.aliyun.com或类似即确认链路通了
检查 ~/.composer/config.json 文件内容是否被正确写入
全局配置本质就是写进这个 JSON 文件。别只信命令返回，打开文件手动确认更稳妥。
关键点：
- 路径中的
~是当前 shell 用户的$HOME，不是 root 的；多用户或 CI 场景下容易写错位置 - 文件里应有形如
"repo": {"packagist": "https://mirrors.aliyun.com/composer/"}的结构，注意是"packagist"字段名，不是"packagist.org"或其他变体 - 若文件权限为
600但属主是 root，而当前用户无读取权，Composer 会降级使用默认源且不报错
在 CI/CD 或容器中验证要显式指定 COMPOSER_HOME
非交互式环境（如 GitHub Actions、Docker build）常因 $HOME 不可写或未定义，导致 config -g 配置失效。
正确做法：
- 先设置环境变量：
export COMPOSER_HOME="/tmp/composer" - 再执行配置：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 最后验证：
composer config -g repo.packagist和composer install -vvv | grep mirrors必须都通过
不这么做，很可能整个构建过程都在默默拉取 packagist.org，直到超时失败才暴露问题。
