Composer install 报错“Could not fetch https://packagist.org/packages.json”是典型网络连通性问题，主因DNS污染、TLS握手失败或HTTPS解密代理干扰；建议优先用curl测试，再切换阿里云镜像并确保User-Agent合规。
Composer install 报错 “Could not fetch https://packagist.org/packages.json”
这是典型的网络连通性问题，不是包本身损坏或配置写错。Packagist 官方源默认走 HTTPS，而国内直连常因 DNS 污染、TLS 握手失败或中间代理干扰导致连接中断。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
curl -I https://packagist.org/packages.json测试终端能否通——如果返回curl: (35) SSL connect error，基本锁定 TLS 层问题 - 检查是否启用了企业级 HTTPS 解密代理（如 Zscaler、Netskope），这类代理会替换证书，而 Composer 默认校验证书链，需额外配置信任
- 临时绕过证书验证（仅调试）：在命令前加
COMPOSER_DISABLE_TLS=1，但不推荐长期使用 - 更稳妥的方式是换镜像源并显式关闭 SSL 验证（若镜像支持 HTTP）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意该镜像已停用，应改用https://mirrors.aliyun.com/composer/）
阿里云镜像源配置后仍 404 或 403
阿里云 Composer 镜像要求 User-Agent 包含 Composer 字样，且部分旧版 Composer（
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认 Composer 版本：
composer --version，低于1.10.22建议升级：composer self-update - 强制刷新全局配置：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不能省） - 检查是否误配了私有仓库规则覆盖了 packagist，运行
composer config -g --list | grep repo查看实际生效的仓库列表 - 如果公司内网有自建 Nexus/Artifactory 代理 Composer 源，需确认其 upstream 是否指向阿里云新地址，而非已下线的老地址（如
https://phpcomposer.com）
HTTPS 请求卡住 30 秒后超时，但 ping 和 curl -v 正常
这不是 DNS 或连通性问题，而是 PHP cURL 扩展在某些 OpenSSL 版本下对 SNI（Server Name Indication）处理异常，尤其在多域名共用 IP 的 CDN 场景（如 Cloudflare 后的镜像站）中容易触发。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
php.ini中添加：curl.cainfo = "/path/to/cacert.pem"（推荐用 Mozilla 官方 CA 包，可从 curl.se 下载） - 避免混用系统自带 OpenSSL 和 Homebrew/MacPorts 安装的 PHP——常见于 macOS，可用
php -r "print_r(openssl_get_cert_locations());"核对default_cert_file路径是否可读 - 临时验证是否为 SNI 问题：在命令行加环境变量
PHP_CURL_SSLVERSION=6（强制 TLSv1.2），再跑composer install - Windows 用户若用 WSL，注意 Windows 主机防火墙可能拦截 WSL 的 outbound HTTPS 请求，可尝试关掉“基于网络位置的防火墙”再测试
私有 Git 包拉取失败，报 “Failed to clone git@xxx: Permission denied (publickey)”
Composer 默认用 SSH 协议拉取 vcs 类型仓库，但不会复用 ssh-agent 的凭据缓存，除非显式启用。很多用户以为配好 ~/.ssh/config 就能自动走 agent-forwarding，其实 Composer 进程不继承 shell 的 agent 环境。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认 SSH key 已加载：
ssh-add -l，若为空，先执行ssh-add ~/.ssh/id_rsa - 在
composer.json中为私有仓库显式指定协议和选项："repositories": [ { "type": "vcs", "url": "https://git.example.com/myvendor/mypackage.git" } ]（改用 HTTPS + token 认证比 SSH 更稳定） - 若必须用 SSH，可在
~/.ssh/config中为对应 Host 添加ForwardAgent yes，并确保 Composer 运行时的 shell 环境里SSH_AUTH_SOCK变量存在 - 注意 GitHub/GitLab 的 personal access token 权限：Composer 用 HTTPS 拉取时需至少勾选
read:packages（GitHub）或api（GitLab）
最易被忽略的是 Composer 的缓存机制——它会在 ~/.composer/cache 里存一份失败响应（比如 403），后续请求即使网络恢复也直接返回缓存错误。遇到“明明修好了配置却还报错”，第一反应应该是 composer clear-cache。
