答案是Git版本过低导致SSL证书问题或克隆失败，应升级Git至2.10+并配置TLS 1.2；CentOS 7用户推荐通过IUS仓库安装git222，同时强制指定新版Git路径或调整PATH优先级。
Composer install 时提示 “fatal: unable to access 'xxx': SSL certificate problem” 或 “git clone failed”
这不是 Composer 的问题，而是它调用 git clone 时底层 Git 版本太低（常见于 CentOS 7 默认的 Git 1.8.3），不支持现代 Git 仓库的协议（如 HTTPS + TLS 1.2+）或新认证方式。直接升级 Git 比绕开更可靠。
- 先确认 Git 版本：
git --version—— 若低于 2.10，基本可判定为根源 - CentOS/RHEL 7 用户优先用 IUS 仓库升级：
yum install https://repo.ius.io/ius-release-el7.rpm，再yum install git222（安装 Git 2.22+） - 避免用
composer config -g github-protocols https临时降级协议，这治标不治本，且部分私有仓库会因此失败 - 升级后执行
git config --global http.sslVersion tlsv1.2，强制使用 TLS 1.2，防止旧系统默认用 TLS 1.0
用 Composer 的 --prefer-source 强制走 git clone 路径时卡在 shallow clone
Git 2.10 以下版本不支持 --shallow-since 和部分 --filter 参数，而 Composer 2.x 在某些场景（如指定 commit 或 dev 分支）会生成这类命令，直接报错退出。
- 错误典型表现：
error: unknown option `shallow-since'或fatal: unrecognized argument: --filter=blob:none - 临时规避：加
--no-shallow参数（仅限 Composer 2.2+），但会拉全量历史，慢且占空间 - 根本解法：升级 Git 后，删掉
vendor/和composer.lock，再跑composer install --prefer-source - 若必须用旧 Git 且不能升级，可退回到 Composer 1.x：
curl -sS https://getcomposer.org/installer | php -- --version=1.10.22，它不生成浅克隆命令
Git 升级后 Composer 仍走旧 Git 二进制路径
某些环境（尤其是 Docker 或多版本共存）里，which git 返回的是新路径，但 Composer 启动时读取的是父进程的 $PATH 缓存，或被硬编码指向旧位置（如 /usr/bin/git）。
- 检查 Composer 实际调用的 Git：
strace -e trace=execve composer install 2>&1 | grep git（Linux） - 强制指定 Git 路径：
composer config -g bin-dir /usr/local/bin，再确保/usr/local/bin/git是新版 - 更稳妥做法：在 shell 配置中把新版 Git 目录（如
/opt/git/bin）放到$PATH最前面，并重启终端或重载配置 - Docker 用户注意：
FROM php:8.2基础镜像自带 Git 2.39+，但自定义FROM centos:7镜像需手动升级并ENV PATH="/opt/git/bin:$PATH"
私有 GitLab/GitHub 仓库因 SSH key 或 token 失效连不上
Git 版本过低常掩盖真实认证问题——比如 TLS 握手失败后，错误日志被截断，误以为是网络或权限问题。
- 先单独测试 Git 连通性：
git ls-remote -h https://gitlab.example.com/group/repo.git，观察是否真卡在 SSL 或 401 - HTTPS 私仓推荐用 Personal Access Token 认证：
https://oauth2:<code>TOKEN@gitlab.example.com/group/repo.git，Token 放在auth.json中 - SSH 方式下，确认
ssh -T git@gitlab.example.com能成功，且git用户的~/.ssh/config中 Host 别名未被旧 Git 忽略（Git < 2.10 不支持Include指令） - Composer 本身不处理证书信任链，若用自签名证书，需额外配
git config --global http."https://gitlab.example.com/".sslCAInfo /path/to/cert.pem
Git 版本低引发的问题往往层层嵌套：SSL 失败 → 认证失败 → 克隆失败 → Composer 报错。真正要盯住的不是 Composer 命令怎么写，而是它背后那个默默执行 git clone 的二进制文件到底能不能扛住现在的协议和加密要求。
