使用shipit.js部署Node.js应用报错：git checkout undefined

我之前处理过好几起类似的Shipit部署报错，这个git checkout undefined基本都是分支参数没正确配置或者传递导致的，给你几个具体的排查和解决步骤：

1. 核对Shipit配置文件的分支设置 #

先打开你的shipitfile.js，重点检查production环境下的分支配置是否正确。正常的配置应该像这样：

module.exports = shipit => {
  require('shipit-deploy')(shipit);

  shipit.initConfig({
    production: {
      servers: 'your-user@your-server-ip',
      repositoryUrl: 'git@github.com:your-username/your-repo.git',
      branch: 'main', // 这里必须明确写你要部署的分支名，比如main、master
      deployTo: '/var/www/your-app-directory',
      // 其他配置...
    }
  });
};

如果branch字段缺失、拼写错误，或者你用了未定义的变量（比如branch: process.env.DEPLOY_BRANCH但这个环境变量没设置），就会触发git checkout undefined的错误。如果是用环境变量的方式，记得在部署前先导出变量：

export DEPLOY_BRANCH=main

2. 检查依赖版本兼容性 #

如果你最近更新了shipit-cli或者shipit-deploy的版本，可能出现新老版本的配置兼容性问题。比如某些新版本对分支参数的读取逻辑有变化。你可以尝试回退到之前能正常部署的版本：
先查看package-lock.json里记录的旧版本号，然后重新安装指定版本：

npm uninstall shipit-cli shipit-deploy
npm install shipit-cli@x.x.x shipit-deploy@x.x.x

替换x.x.x为你之前正常部署时的版本号。

3. 验证分支参数的命令行传递 #

如果你的配置支持通过命令行指定分支，要确保部署命令里的分支参数正确传递。比如：

./node_modules/shipit-cli/bin/shipit production deploy start --branch=main

另外，也可以在本地先测试一下git命令是否能正常checkout目标分支，执行git checkout main（替换成你的分支名），确认本地仓库没有异常。

4. 清理临时工作区后重试 #

错误日志里提到了删除/tmp/github-monitor，但可能临时工作区还有残留的异常文件。手动清理这个目录后再重新部署：

rm -rf /tmp/github-monitor
./node_modules/shipit-cli/bin/shipit production deploy start

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