Composer怎么排查安全连接失败问题-composer-PHP中文网

composer ssl证书验证失败主因是php找不到或加载了过期/损坏的根证书，需执行php -r "print_r(openssl_get_cert_locations());"检查default_cert_file和ini_cafile路径，常见于路径错误、文件为空、系统时间偏差或镜像源证书不受信。

composer怎么排查安全连接失败问题

SSL证书验证失败：检查PHP的CA证书路径和内容

Composer报SSL3_GET_SERVER_CERTIFICATE: certificate verify failed，大概率不是网络问题，而是PHP找不到或加载了过期/损坏的根证书。它依赖OpenSSL扩展读取系统级CA证书文件，一旦路径错、文件空、或内容陈旧，所有HTTPS请求（包括镜像源）都会中断。

执行php -r "print_r(openssl_get_cert_locations());"，重点看default_cert_file和ini_cafile指向的路径。常见错误包括：

路径存在但文件为空或只有几行（比如CentOS的/etc/pki/tls/cert.pem被清空）
PHP CLI和Web服务器用不同php.ini，只改了其中一个
容器环境里没挂载宿主机证书，或Alpine镜像缺ca-certificates包

修复方法：下载最新根证书覆盖原文件，例如wget --no-check-certificate https://curl.se/ca/cacert.pem -O /etc/pki/tls/cert.pem（注意权限需PHP进程可读）。

https-proxy配置写成https://开头：502 Bad Gateway的直接诱因

用代理时出现502 Bad Gateway却没超时或TLS错误，十有八九是https-proxy值写错了。Composer对代理协议有硬性约定：https-proxy必须以http://开头，哪怕代理服务本身跑在HTTPS端口上。

错误写法会直接导致隧道建立失败后返回非标响应，网关判定为上游异常：

composer config -g repo.packagist.org.ssl-proxy https://127.0.0.1:7890 → 必报502
composer config -g repo.packagist.org.ssl-proxy http://127.0.0.1:7890 → 正确（即使代理监听443也得写http://）

同时必须配http-proxy，否则HTTP流量走直连，HTTPS走代理，混合出问题。验证方式：用curl -x http://127.0.0.1:7890 https://repo.packagist.org/packages.json复现，如果curl也502，就是代理链本身的问题，不是Composer。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

系统时间偏差过大：SSL握手无声失败的隐藏原因

证书有效期是硬性校验项。若本地系统时间比真实时间快几小时或慢几天，OpenSSL会在握手阶段直接拒绝证书，Composer表现为“无法下载”或卡住，日志里可能只显示Connection refused或空响应，不提SSL。

检查方式很简单：

Linux/macOS：date对比curl -I https://google.com 2>/dev/null | grep date返回的服务器时间
Windows：任务栏右下角时间右键→“调整日期和时间”→确认“自动设置时间”已开

尤其在Docker容器、VM或CI环境中，宿主机时间同步未开启时极易发生。一个sudo ntpdate -s time.nist.gov（或systemctl restart systemd-timesyncd）就能解决，不需要动Composer任何配置。

镜像源强制HTTPS但证书不受信：阿里云等国内镜像的典型表现

切了阿里云镜像https://mirrors.aliyun.com/composer/仍报SSL错误，说明问题不在Packagist直连，而在镜像站自身证书链。阿里云使用的是自有CA签发的证书，部分老旧系统或定制PHP环境没预置其根证书。

临时验证方法：用curl -v https://mirrors.aliyun.com/composer/packages.json看是否提示unable to get local issuer certificate。如果是，有两个选择：

把阿里云根证书追加到PHP的cert.pem里（需先从浏览器导出或用openssl s_client -connect mirrors.aliyun.com:443 -showcerts提取）
退一步用HTTP镜像（不推荐长期）：composer config -g repos.packagist composer http://mirrors.aliyun.com/composer/

真正干净的解法是更新系统CA证书包（如sudo yum update ca-certificates），而不是给Composer打补丁。安全连接失败的根因，往往藏在PHP和系统层面，而不是composer.json里。