如何解决Composer的 "Could not read from remote repository" 错误_SSH密钥与Git仓库访问权限排查指南

首先确认使用SSH协议，检查composer.json中仓库URL是否为git@格式；若无SSH密钥则生成ed25519类型并添加公钥至GitHub/GitLab；通过ssh -T测试连接；确保ssh-agent运行并加载密钥；清除Composer缓存后重试安装，或改用HTTPS配合个人访问令牌及auth.json配置认证。

遇到 Composer 报错 "Could not read from remote repository" 通常意味着 Git 在尝试克隆私有仓库时无法通过 SSH 正确认证。这个问题常见于项目依赖了托管在 GitHub、GitLab 或私有 Git 服务器上的私有包。下面一步步排查并解决 SSH 密钥与仓库访问权限问题。

确认是否使用 SSH 协议

Composer 安装私有包时，如果仓库地址以 git@ 开头（如 git@github.com:username/repo.git），则使用的是 SSH 协议，必须配置正确的 SSH 密钥才能访问。

检查 composer.json 中的仓库配置：

如果是 HTTPS 地址（如 https://github.com/...），则不需要 SSH 密钥，但可能需要个人访问令牌（PAT）。若你希望用 SSH，确保 URL 使用 git@... 格式。

检查本地 SSH 密钥是否存在

打开终端，运行以下命令查看是否已有 SSH 密钥：

推荐使用更安全的 ed25519 类型密钥。如果没有输出或提示文件不存在，生成新的密钥：

按提示保存到默认路径（如 ~/.ssh/id_ed25519），可设置密码增强安全性。

将公钥添加到 Git 服务

复制公钥内容（注意是 .pub 文件）：

全选并复制输出内容。然后根据你的 Git 平台操作：

• GitHub：进入 Settings → SSH and GPG keys → New SSH key，粘贴公钥
• GitLab：Settings → SSH Keys，粘贴并保存
• 自建 Git 服务器：将公钥追加到 ~git/.ssh/authorized_keys

保存后，可通过以下命令测试连接：

如果看到类似 Hi username! You've successfully authenticated...，说明 SSH 配置成功。

标签： linux word js git json composer windows github access mac ai