Azure DevOps执行git tag报‘fatal: bad object type’错误求助

我在Azure DevOps中配置了一个为提交打标签的Pipeline任务，脚本如下：

- job:
  steps:
  - checkout: self
    persistCredentials: true
  - powershell: |
      $longBuildNumber = '$(Build.BuildNumber)'
      $tag = "RC" + $longBuildNumber
      $commitSha = '$(resources.pipeline.build-all.sourceCommit)'
      Write-Host $tag
      Write-Host $commitSha
      $tagComment = "Testing "
      git config --global user.name "BuildService"
      git config --global user.email "buildservice@pipeline.com"
      git tag -a $tag $commitSha -m $tagComment
      git push --tags

提交SHA值来自负责构建制品的build-allPipeline，用户可通过点击「Resources」选择要打标签的构建，点击Pipeline名称可查看已完成运行记录及制品。但该任务有时成功有时失败，失败时返回：

RC20230717.60
9f9b86b7cxxxxxxxxxxxxxxxxxxxxxxxxxxx
fatal: bad object type.
Everything up-to-date

1. 确保本地仓库能访问目标提交SHA #

fatal: bad object type的核心原因是本地检出的仓库中找不到指定的提交SHA，优先排查以下两点：

• 跨仓库资源引用问题：如果build-all流水线的源仓库和当前打标签流水线的仓库不是同一个，checkout: self只会拉取当前仓库代码，自然找不到另一个仓库的提交。需要添加步骤检出目标仓库：

  - checkout: self
    persistCredentials: true
  - checkout: build-all-repo-name # 替换为build-all的源仓库名称
    persistCredentials: true
    path: build-all-repo # 指定路径避免目录冲突
  

  然后在PowerShell脚本中切换到对应目录执行打标签操作。
• 浅克隆限制：Azure DevOps默认checkout是浅克隆（仅拉取最近1次提交），如果目标SHA不在浅克隆历史范围内，就会找不到。修改checkout步骤拉取完整历史：

  - checkout: self
    persistCredentials: true
    fetchDepth: 0 # 拉取所有历史提交
  

2. 验证提交SHA的有效性 #

在失败时打印的SHA，手动在仓库中执行git show <SHA>确认是否存在：

• 如果SHA不存在，说明build-all流水线的sourceCommit可能指向了被强制推送覆盖、删除的提交，需要检查build-all对应的分支是否有强制推送操作。
• 可以在脚本中添加预检查，提前终止错误流程：

  # 检查提交SHA是否存在
  if (-not (git rev-parse --verify $commitSha > $null 2>&1)) {
      Write-Error "Commit SHA $commitSha does not exist in local repository."
      exit 1
  }
  

3. 避免重复打标签 #

错误中的Everything up-to-date说明标签可能已存在，脚本中可先检查标签是否存在，跳过重复操作：

if (git tag -l $tag) {
    Write-Host "Tag $tag already exists, skipping tag creation."
    exit 0
}

4. 确认权限与配置 #

• 确保Pipeline使用的服务账号（BuildService）拥有仓库的读写权限，包括创建标签和推送标签的权限。
• 可在脚本中添加git配置验证，确保用户信息正确：

  Write-Host "Git user config:"
  git config --global user.name
  git config --global user.email
  

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