Node.js/Angular向Bitbucket提交文件遇EC2及SSL问题，求替代方案

一、搞定nodegit的SSL证书错误 #

如果是临时测试场景，可以临时跳过SSL验证（生产环境不建议这么做），在克隆时添加配置：

const Git = require("nodegit");

Git.Clone("https://bitbucket.org/你的仓库地址", "./tmp", {
  fetchOpts: {
    callbacks: {
      certificateCheck: () => 0 // 跳过SSL证书校验
    }
  }
})
.then(repo => console.log('克隆成功'))
.catch(err => console.log(err));

生产环境下，需要将Bitbucket的根证书添加到EC2服务器的信任存储中，或者在nodegit配置里指定证书路径。

二、解决"legacy HTTP transport protocol"错误 #

这个错误是因为使用了旧版Git HTTP传输协议，两种解决思路：

• 升级nodegit依赖的libgit2版本，确保支持现代HTTP传输协议；
• 改用SSH协议克隆/推送（前提是EC2服务器已配置Bitbucket SSH密钥）：

Git.Clone("git@bitbucket.org:你的仓库地址.git", "./tmp", {
  fetchOpts: {
    callbacks: {
      credentials: (url, userName) => {
        return Git.Cred.sshKeyFromAgent(userName);
      }
    }
  }
})

三、推送单个文件的替代方法 #

方法1：使用Bitbucket REST API #

无需克隆整个仓库，直接通过API上传单个文件，效率更高：

const axios = require('axios');
const fs = require('fs');

const repoOwner = '你的Bitbucket用户名';
const repoSlug = '仓库名';
const localFilePath = '本地要推送的文件路径';
const apiUrl = `https://api.bitbucket.org/2.0/repositories/${repoOwner}/${repoSlug}/src`;
// 使用Bitbucket应用密码（别用账户密码，仅授予仓库读写权限）
const auth = {
  username: '你的用户名',
  password: '你的应用密码'
};

// 将文件转成base64格式
const fileContent = fs.readFileSync(localFilePath, { encoding: 'base64' });

axios.post(apiUrl, {
  message: '更新单个文件',
  branch: 'main', // 目标分支
  files: {
    '仓库内目标路径/文件名.txt': { // 文件在仓库中的存储路径
      content: fileContent
    }
  }
}, { auth })
.then(() => console.log('文件推送成功'))
.catch(err => console.log(err.response.data));

方法2：使用simple-git库（轻量Git封装） #

simple-git对Git命令的封装更简洁，兼容性更好：

const simpleGit = require('simple-git');
const fs = require('fs');
const path = require('path');

const tempDir = './临时仓库目录';
const git = simpleGit();

// 浅克隆仓库，仅拉取最新版本，速度更快
git.clone('https://bitbucket.org/你的仓库地址', tempDir, ['--depth', '1'])
.then(() => {
  // 复制本地文件到临时仓库
  fs.copyFileSync('本地文件路径', path.join(tempDir, '仓库目标文件名.txt'));
  // 执行添加、提交、推送操作
  return git.cwd(tempDir)
    .add('仓库目标文件名.txt')
    .commit('更新单个文件')
    .push('origin', 'main');
})
.then(() => console.log('推送成功'))
.catch(err => console.log(err));

若遇到SSL错误，可初始化时添加配置跳过验证（生产环境谨慎使用）：

const git = simpleGit({
  config: ['http.sslVerify=false']
});

方法3：直接调用系统Git命令 #

通过Node.js的child_process执行原生Git命令，兼容性拉满：

const { execSync } = require('child_process');
const fs = require('fs');
const path = require('path');

const tempDir = './临时仓库';
// 用应用密码拼接仓库URL，建议将敏感信息存到环境变量中，避免泄露
const repoUrl = 'https://你的用户名:你的应用密码@bitbucket.org/你的仓库地址.git';

// 浅克隆仓库
execSync(`git clone --depth 1 ${repoUrl} ${tempDir}`);
// 复制本地文件到仓库目录
fs.copyFileSync('本地文件路径', path.join(tempDir, '仓库目标文件名.txt'));
// 执行Git提交推送命令
execSync(`cd ${tempDir} && git add 仓库目标文件名.txt && git commit -m "更新文件" && git push`);

console.log('推送完成');

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