composer 提示 "Could not read from remote repository" Git 权限问题

答案是SSH配置或权限问题导致，需检查SSH密钥是否生成并添加到GitHub/GitLab，测试ssh -T git@github.com连接；确保Composer使用正确协议，可改为HTTPS或配置全局协议；确认Git能手动克隆仓库；若用HTTPS需配置个人访问令牌（PAT）并设置composer github-oauth。

当你在使用 Composer 安装依赖时遇到 "Could not read from remote repository" 错误，通常是因为 Git 无法通过 SSH 访问远程仓库（比如 GitHub、GitLab 等），这多数是 SSH 配置或权限问题导致的。下面是一些常见原因和解决方法。

1. 检查 SSH 密钥是否配置正确

Composer 在拉取私有仓库时默认使用 SSH 协议（如 git@github.com:username/repo.git），需要本地有对应的 SSH 密钥，并且已添加到代码平台（如 GitHub）。

• 如果你还没生成 SSH 密钥，运行：

ssh-keygen -t ed25519 -C "your_email@example.com"

• 将公钥（通常是 ~/.ssh/id_ed25519.pub）内容复制并添加到你的 GitHub/GitLab 账户的 SSH Keys 设置中。 • 测试连接：

ssh -T git@github.com

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

2. 确保 Composer 使用正确的协议

有时 Composer 会尝试用 SSH 拉取本应公开的包，但如果你没有权限或未登录，就会失败。你可以强制 Composer 使用 HTTPS 协议代替 SSH。

• 修改 composer.json 中的仓库地址，从：

"url": "git@github.com:username/private-repo.git"

改为：

"url": "https://github.com/username/private-repo.git"

• 或者全局配置 Composer 使用 HTTPS：

composer config --global github-protocols https

• 也可以为 Git 配置替换规则：

git config --global url."https://github.com/".insteadOf "git@github.com:"

这样所有 SSH 地址都会自动转为 HTTPS，适合公司代理或无密钥环境。

3. 检查 Git 是否能正常访问仓库

手动测试一下 Git 是否能克隆该仓库：

Studio Global

Studio Global AI 是一个内容生成工具，帮助用户客制化生成风格和内容，以合理价格提供无限生成，希望将 AI 带给全世界所有人。

405 查看详情

git clone git@github.com:username/private-repo.git

• 如果失败，说明是 Git 层的问题，不是 Composer 的问题。 • 常见错误包括：密钥未加载、代理设置、防火墙、SSH agent 未运行等。 • 确保 SSH agent 正在运行并添加了密钥：

eval "$(ssh-agent -s)"

ssh-add ~/.ssh/id_ed25519

4. 使用个人访问令牌（PAT）配合 HTTPS

如果你改用 HTTPS 方式访问私有仓库，GitHub 已不再支持密码认证，需使用 Personal Access Token (PAT)。

• 创建 PAT：进入 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → 生成一个带 repo 权限的 token。 • 使用时将 token 当作密码：

https://TOKEN@github.com/username/private-repo.git

或在 Composer 中配置：

composer config --global github-oauth.github.com YOUR-TOKEN-HERE

这是 Composer 推荐的安全方式，避免频繁输入凭证。

基本上就这些。重点排查 SSH 密钥、Git 协议、远程权限和 Composer 配置。只要 Git 能手动克隆，Composer 一般就没问题。

以上就是composer 提示 "Could not read from remote repository" Git 权限问题的详细内容，更多请关注其它相关文章！