答案：SSH认证失败需检查密钥配置、启动SSH agent并测试连接。确认本地存在id_rsa或id_ed25519密钥，若无则生成；将公钥添加至GitHub/GitLab；执行ssh -T git@github.com测试连通性；确保ssh-agent运行且密钥已加载；必要时通过composer config --global github-protocols https临时改用HTTPS协议拉取依赖。
当使用 Composer 安装依赖时，如果项目依赖的包通过 Git SSH 地址拉取（如 git@github.com:vendor/package.git），而 SSH 认证失败，Composer 会报错无法克隆仓库。这类问题通常与本地 SSH 密钥配置有关。以下是排查和解决该问题的步骤。
确认 SSH 密钥存在并正确配置
确保你已经在本地生成了 SSH 密钥，并将其添加到对应的代码平台（如 GitHub、GitLab 等）。
- 检查是否存在私钥文件，通常位于：
~/.ssh/id_rsa或~/.ssh/id_ed25519 - 如果没有，请运行
ssh-keygen -t ed25519 -C "your_email@example.com"生成新密钥 - 将公钥（如
id_ed25519.pub）内容复制并添加到 GitHub/GitLab 的 SSH Keys 设置中
测试 SSH 连接是否正常
在终端执行以下命令，验证与远程仓库的连接：
ssh -T git@github.com
如果是 GitLab：
ssh -T git@gitlab.com
成功后会看到类似 Hi username! You've successfully authenticated... 的提示。若失败，请检查网络、SSH 配置或代理设置。
确保 SSH agent 正在运行并加载了密钥
SSH agent 负责管理私钥，Composer 通过 Git 调用 SSH，依赖 agent 提供认证。
- 启动 agent：
eval $(ssh-agent) - 添加私钥：
ssh-add ~/.ssh/id_rsa或对应密钥路径 - 确认已加载：
ssh-add -l
某些系统（如 Linux 桌面版或 macOS）会自动管理 agent，但服务器或 CI 环境常需手动操作。
让 Composer 使用 HTTPS 替代 SSH（临时绕过）
如果你暂时无法修复 SSH 问题，可让 Composer 强制使用 HTTPS 协议拉取包：
composer config --global github-protocols https
或修改 composer.json 中的仓库地址为 HTTPS 格式：
"repositories": [
{
"type": "vcs",
"url": "https://github.com/vendor/package.git"
}
]
注意：使用 HTTPS 可能需要个人访问令牌（PAT）进行身份验证，尤其是在私有仓库场景下。
检查 Git 是否使用 SSH 并配置正确
确认 Git 的 URL 映射没有错误。有时全局配置可能强制切换协议。
- 查看当前 Git 配置：
git config --global --get url."git@github.com:".insteadOf - 如果有不正确的替换规则，可用
git config --global --unset删除
基本上就这些。Composer 本身不直接处理 SSH，而是调用系统 Git，Git 再通过 SSH 通信。因此问题根源几乎都在 SSH 或 Git 配置上。只要确保密钥存在、agent 加载、远程服务认可公钥，就能解决认证失败问题。
