如何解决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 配置成功。

AI Surge Cloud

低代码数据分析平台，帮助企业快速交付深度数据

87

查看详情

确保 SSH agent 正在运行并加载密钥

SSH agent 负责管理密钥，避免重复输入密码。启动 agent 并添加密钥：

如果你使用不同的密钥名，请替换对应路径。Windows 用户若使用 Git Bash，操作相同。

某些系统（如 macOS）会自动管理 agent，Linux 桌面环境也可能集成。若每次重启都需要重新添加，可将上述命令加入 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）。

Composer 清除缓存并重试

Composer 可能缓存了之前的失败请求。清除缓存后再运行安装：

如果仍失败，启用详细日志查看具体错误：

从输出中查找 Cloning into ... 和 fatal: Could not read from remote repository 上下文，确认是否为权限问题。

备用方案：使用 HTTPS + 访问令牌

若不想配置 SSH，可改用 HTTPS 并配合个人访问令牌（PAT）：

• 在 GitHub/GitLab 生成 PAT，权限包含 repo
• 修改仓库 URL 为 HTTPS：
  https://github.com/username/private-package.git
• Composer 会提示输入用户名和密码，用户名任意，密码填 PAT

也可在 auth.json 中预先配置：

该文件应放在项目根目录或 Composer 全局配置路径（composer config --global home 查看）。

基本上就这些。关键点在于确认协议类型、正确配置 SSH 密钥并确保其被 Git 服务信任。只要 SSH 能通，Composer 就能正常拉取代码。

以上就是如何解决Composer的 "Could not read from remote repository" 错误_SSH密钥与Git仓库访问权限排查指南的详细内容，更多请关注php中文网其它相关文章！