验证 Composer 镜像源是否成功配置的唯一可靠方式是执行 composer config -g repo.packagist 并检查输出是否为完整 JSON，且严格满足三个条件：type 字段必须为 "composer"、url 必须是 HTTPS 协议、url 必须以 / 结尾。
composer config -g repo.packagist 输出必须是完整 JSON
这条命令是验证镜像源是否写入成功的唯一可靠方式。输出为空、null、{}、"https://packagist.org" 或带多余空格的字符串，都代表失败。正确输出只能是形如：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
三个硬性条件缺一不可：type 字段必须显式存在且值为 "composer"；url 必须是 HTTPS 协议（HTTP 会被静默拒绝）；url 必须以 / 结尾（漏掉会拼出错误路径，如 /packages.json 变成 packages.json，直接 404）。
常见手误：repos.packagist（多一个 s）、漏写 composer 类型参数、URL 拼成 http:// 或末尾没斜杠。Composer 2.5+ 对这些校验极严，错一处就静默 fallback 到官方源，且不报错。
composer diagnose 中 Repo packagist.org 行必须匹配镜像地址
composer diagnose 不只是环境检查工具，它会主动解析当前生效的仓库配置。重点看这行输出：Repo packagist.org: https://mirrors.aliyun.com/composer/。
这个 URL 必须和 composer config -g repo.packagist 的输出**完全一致**：协议、域名、路径、结尾斜杠，一个字符都不能差。如果这里仍是 https://packagist.org 或 https://repo.packagist.org，说明配置未被识别——大概率是项目级 composer.json 中的 repositories 字段覆盖了全局设置。
验证方法：cd 进项目根目录后执行 composer config repo.packagist。若有输出，坐实覆盖；若提示 Key "repo.packagist" does not exist，才继续排查全局配置或缓存。
composer require -vvv 日志里必须出现镜像域名的 GET 请求
最终验证必须落到网络请求上。配置再对，不发包就不算真生效。执行：
composer clear-cache && composer require monolog/monolog -vvv 2>&1 | grep "GET https"
关键看日志中是否出现类似这样的行：GET https://mirrors.aliyun.com/composer/packages.json。
如果看到的是 GET https://packagist.org/packages.json 或 GET https://repo.packagist.org/packages.json，说明镜像完全没走。可能原因包括：
- 项目
composer.json里定义了"repositories": [...]，且其中某条记录的type不是"composer"，或 URL 缺少末尾/ - 环境变量
COMPOSER_REPO_PACKAGIST被设为原始地址 - Docker 多阶段构建中，
composer config -g写入的是/root/.composer/config.json，但运行时用户是www-data，读不到
注意：首次切换镜像时，packages.json 下载可能卡在 “Loading composer repositories” 达 1–5 分钟，这是正常行为，不是失败。
HTTPS 协议与证书问题常被忽略
即使 config 和 diagnose 都显示正确，require -vvv 仍连不上，大概率是 HTTPS 层失败。典型表现是请求超时、SSL certificate problem 或 Could not fetch 后无具体 URL。
常见场景：
- Alpine 镜像默认不带 CA 证书：必须加
RUN apk add --no-cache ca-certificates - 公司内网拦截 HTTPS 流量，自签名代理证书未导入系统信任库
- 镜像服务端 TLS 版本过旧（如仅支持 TLS 1.0），而 Composer 依赖的 PHP cURL 默认禁用
快速验证：curl -I https://mirrors.aliyun.com/composer/packages.json。能返回 200 OK 且含 Content-Type: application/json，说明 HTTPS 层通；若报 SSL 错误，则问题不在 Composer 配置本身。
