答案是SSH agent未启用或密钥未加载且Git未配置SSH agent转发。需在执行composer install的机器上运行ssh-add -l确认密钥已加载，启用ssh-agent并设置git config --global core.sshCommand "ssh -o ForwardAgent=yes"，同时确保SSH连接时启用ForwardAgent=yes。
Composer install 报错 “git@github.com: Permission denied (publickey)”
这是典型的 SSH 认证失败，不是密码错误，而是 SSH agent 没有加载私钥，或 Git 无法通过 SSH agent 转发密钥。Composer 在拉取 git@ 协议的包（比如私有仓库、dev-master 分支）时，会调用系统 Git，而 Git 默认不启用 SSH agent forwarding —— 即使你本地 ssh-add -l 能看到密钥，远程服务器上也拿不到。
检查当前 SSH agent 是否生效且密钥已加载
在执行 composer install 的机器（尤其是 CI/CD 服务器或跳板机）上运行：
ssh-add -l
如果输出为空或报错 Could not open a connection to your authentication agent，说明 agent 未启动或未继承到当前 shell。
- 临时启用：
eval $(ssh-agent)，再ssh-add ~/.ssh/id_rsa - 但更关键的是：确保 SSH 连接时启用了 agent forwarding —— 客户端连接服务器时必须加
-o ForwardAgent=yes，否则子进程（如 Git）根本访问不到你的本地 agent - 别依赖
~/.ssh/config里的ForwardAgent yes，除非你确认该配置被实际匹配（比如 Host 别名是否对得上目标主机）
Git 配置需显式启用 SSH command 并透传 agent
即使 SSH 连接开启了 forwarding，Git 有时仍会绕过它，尤其在非交互式环境（如 Docker、CI）。强制 Git 使用标准 OpenSSH 命令并继承环境变量：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
git config --global core.sshCommand "ssh -o ForwardAgent=yes"
这个配置让 Git 所有 SSH 操作都带上转发开关，比依赖系统默认行为更可靠。
- 验证是否生效：
git ls-remote git@github.com:your-org/private-repo.git，成功返回 ref 表示通了 - 如果仍失败，检查
ssh -T git@github.com是否提示 “Hi xxx! You've successfully authenticated”，否则问题不在 Composer，而在基础 SSH 连通性 - 注意：不要用
core.sshCommand="ssh -i /path/to/key"硬编码私钥路径，这会绕过 agent，丧失多密钥管理和安全性
Composer 自身不处理 SSH，别在 composer.json 里瞎配
有人试图在 composer.json 的 repositories 里写 "url": "ssh://git@..." 并幻想 Composer 能接管认证 —— 不行。Composer 只是调用 Git 命令，所有 SSH 行为完全由系统 Git 和底层 SSH 控制。
- 删掉任何试图用
http-basic凭据去“覆盖”git@地址的 hack，HTTP 和 SSH 认证机制完全不同，混用只会掩盖真实问题 - 私有包若必须走 SSH，唯一可控点就是：确保运行
composer install的用户能无交互执行git clone git@... - 在容器中尤其注意：默认不继承宿主机的
SSH_AUTH_SOCK，需挂载该 socket 文件并设置环境变量，否则 agent forwarding 形同虚设
真正卡住的地方往往不是 Composer 或 Git 配置本身，而是 SSH agent 的生命周期管理 —— 它容易在非登录 shell、systemd service、Docker entrypoint 中丢失上下文。每次遇到权限拒绝，先问：当前 shell 环境里 $SSH_AUTH_SOCK 存在吗？ssh-add -l 有输出吗？ssh -O forward git@github.com 能连上吗？
