Bash批量重命名GitHub分支遇404错误及空值判断问题

1. 定位gh: Not Found (HTTP 404)错误 #

• 检查仓库参数格式：脚本遍历仓库时，确认仓库标识是用户名/仓库名的完整格式，避免漏写组织/用户名或拼写错误。set -x输出里如果gh repo view类命令返回null，大概率是仓库标识不对。
• 验证账号权限：当前gh登录账号必须有目标仓库的读写权限，手动执行gh repo view <仓库全名>测试——GitHub有时会用404替代权限不足的提示。
• 核对API端点：如果脚本直接调用GitHub API，确保路径正确（比如/repos/{owner}/{repo}/branches），别用错端点。

2. 修复if条件判断失效与null值问题 #

• 修正分支检测逻辑：别直接用字符串匹配JSON输出，改用jq精准提取分支名，避免null干扰判断：

  has_main=$(gh repo view --json branches -R $REPO | jq '.branches[] | .name' | grep -q '"main"' && echo "yes" || echo "no")
  has_master=$(gh repo view --json branches -R $REPO | jq '.branches[] | .name' | grep -q '"master"' && echo "yes" || echo "no")
  

  用明确的yes/no值替代模糊的JSON输出，保证条件判断可靠。
• 过滤仓库列表的无效数据：如果用gh repo list获取仓库，必须用jq提取有效条目，避免输出包含null：

  gh repo list --json nameWithOwner | jq -r '.[].nameWithOwner' | while read REPO; do
      # 单个仓库处理逻辑
  done
  

• 初始化变量：循环开始前提前初始化has_main、has_master这类变量，避免未赋值导致的null值干扰判断。

3. 解决“单独调用正常、批量失败”的矛盾 #

• 添加请求延迟：GitHub API有速率限制，批量处理时在循环中加入sleep 1，避免触发限制导致请求失败。
• 清理仓库列表：检查批量遍历的仓库列表，移除已删除、改名的无效仓库，这类仓库会导致gh命令返回404或null。
• 清空环境变量：脚本中避免依赖GH_REPO这类全局环境变量，循环内每次处理新仓库时，确保相关变量被重置。

4. 高效调试技巧 #

• 在关键步骤加日志输出，直观查看变量值：

  echo "正在处理仓库: $REPO"
  echo "是否存在main分支: $has_main"
  echo "是否存在master分支: $has_master"
  

• 先把单个仓库的处理逻辑单独测试，确认逻辑无误后再套入批量循环。

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