如何解决 Composer 在 macOS 上因 keychain 权限导致的认证失败？

Composer在macOS因keychain权限拒绝导致Git认证失败，需检查钥匙串凭据权限、配置git credential.helper为osxkeychain、避免Composer回退HTTPS，并重置Git凭据触发重新授权。

Composer 在 macOS 上因 keychain 权限拒绝访问凭据，会导致 git clone 或私有包安装时认证失败（如 401 Unauthorized 或 Permission denied (publickey)），根本原因是 Git 尝试从系统 keychain 读取凭证时被 macOS 安全策略拦截。

检查并修复 keychain 中的 Git 凭据条目

macOS 的钥匙串可能存有损坏、过期或权限受限的 Git 凭据（如 github.com、gitlab.com 等）。打开“钥匙串访问”应用，搜索 github.com 或对应 Git 域名，找到类型为 Internet password 的条目。双击打开，点击“访问控制”，确认“允许所有应用程序访问此项目”已勾选；若未勾选，勾选后点击“好”保存。也可直接删除旧条目，让 Git 下次自动重新存储（需配合正确的凭据配置）。

确保 Git 使用 osxkeychain 正确辅助工具

运行以下命令确认 Git 已启用 keychain 辅助：

git config --global credential.helper

应输出 osxkeychain。若为空或错误，执行：

标签： macos composer word js git json github app internet 工具 mac a