如何通过Composer排查无法连接到Packagist的问题？

本文共计932个文字，预计阅读时间需要4分钟。

此命令非常常见，用于检查`composer`配置的问题。它仅连接到+3C代码块+https://packagist.org+3C代码块+，并检查你的`composer.json`文件中的镜像源和`COMPOSER_REPO_PACKAGIST`环境变量。如果它失败，可能是因为你日常安装的包存在失败。具体来说，它会告诉你：

验证镜像是否真生效，别信 diagnose，直接跑：

• composer show -p | head -5 —— 它走当前实际配置，能拉出包列表就说明镜像通了
• 临时让 diagnose 测镜像：先 composer config --global --unset repos.packagist，再运行 composer diagnose
• 某些企业镜像会静默丢弃非白名单 User-Agent（比如 Composer/2.x），这时 curl -A "Composer/2.x" https://mirrors.aliyun.com/composer/packages.json 才能复现真实行为

换了镜像源还是连不上，缓存和项目级配置在干扰

镜像配完不生效，90% 是因为缓存没清，或项目级配置覆盖了全局设置。