答案是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）。

Pilot Digital Twin Setup

部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……

下载

• 检查 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 Include 指令）
• Composer 本身不处理证书信任链，若用自签名证书，需额外配 git config --global http."https://gitlab.example.com/".sslCAInfo /path/to/cert.pem

Git 版本低引发的问题往往层层嵌套：SSL 失败 → 认证失败 → 克隆失败 → Composer 报错。真正要盯住的不是 Composer 命令怎么写，而是它背后那个默默执行 git clone 的二进制文件到底能不能扛住现在的协议和加密要求。