使用NodeGit克隆仓库仅获.git目录且触发断言失败错误求助

看起来你遇到的问题核心是NodeGit依赖的libgit2库在HTTP传输流程中无法获取有效凭证，导致克隆过程中断，只完成了.git目录的初始化，而没有拉取实际文件。结合你的配置和报错信息，我整理了几个针对性的解决方案：

1. 确认仓库URL与凭证类型匹配 #

你的cloneOptions配置的是SSH密钥凭证，但如果你的remoteUrl是HTTPS格式（比如https://github.com/username/repo.git），就会出现协议不匹配的问题——libgit2用HTTP协议请求，却找不到对应的HTTP凭证，触发Assertion failed: (t->cred)错误。

• 如果你想用SSH密钥，把remoteUrl改成SSH格式：git@github.com:username/repo.git
• 如果你必须用HTTPS URL，需要把凭证换成HTTP类型的（比如用户名密码或个人访问令牌，推荐用令牌避免明文密码）：

  credentials() {
    return Git.UserpassPlaintextNew(options.username, options.personalAccessToken);
  }
  

2. 修复SSH密钥的路径与权限问题 #

如果确实使用SSH协议，检查以下两点：

• 确保options.publickey和options.privatekey的绝对路径拼写正确（你给出的/Users/safa/.ssh/id_rsa.pub和/Users/safa/.ssh/id_rsa看起来没问题，但可以手动验证文件是否存在）
• 调整SSH密钥文件的权限：MacOS对SSH密钥权限要求严格，私钥id_rsa必须设置为600权限，公钥id_rsa.pub设置为644权限，否则会被SSH客户端拒绝：

  chmod 600 /Users/safa/.ssh/id_rsa
  chmod 644 /Users/safa/.ssh/id_rsa.pub
  

3. 优化克隆配置，避免手动Checkout #

你当前的代码在克隆完成后手动Checkout master分支，可以简化配置，直接在cloneOptions中指定checkoutBranch，让NodeGit自动完成拉取和检出：

this.cloneOptions = {
  checkoutBranch: 'master', // 直接指定要检出的分支
  fetchOpts: {
    callbacks: {
      certificateCheck() { return 1; },
      credentials() {
        return Git.sshKeyMemoryNew(
          options.username,
          options.publickey,
          options.privatekey,
          options.passphrase,
        );
      },
    },
  },
};

这样克隆完成后就直接得到完整的工作目录，无需额外的checkoutRef调用。

4. 升级Node和NodeGit版本 #

你使用的Node v8.5.0是已停止维护的老旧版本，可能和当前NodeGit版本存在兼容性问题。建议：

• 升级Node.js到LTS版本（比如v16或v18，可参考NodeGit官方兼容文档选择）
• 重新安装NodeGit，确保版本与新Node版本兼容：

  npm uninstall nodegit
  npm install nodegit
  

额外排查步骤 #

如果问题仍然存在，可以在credentials回调中添加日志，确认回调是否被触发，以及密钥路径是否正确：

credentials() {
  console.log('Credentials callback triggered');
  console.log('Public key path:', options.publickey);
  console.log('Private key path:', options.privatekey);
  return Git.sshKeyMemoryNew(
    options.username,
    options.publickey,
    options.privatekey,
    options.passphrase,
  );
}

内容的提问来源于stack exchange，提问作者SafaOrhan