Azure DevOps中GitVersion处理feature分支时抛出异常求助

问题描述 #

我们正将项目流水线从Azure DevOps UI步骤迁移为GitVersion+YAML配置，2个月前的测试在部分项目中运行正常。今日迁移另一项目时，相同配置下feature/xxx或features/xxx分支构建在gitversion/execute@0步骤抛出异常：

System.InvalidOperationException: Gitversion could not determine which branch to treat as the development branch (default is 'develop') nor release-able branch (default is 'main' or 'master'), either locally or remotely. Ensure the local clone and checkout match the requirements or considering using 'GitVersion Dynamic Repositories'

develop和master分支构建正常，仓库中同时存在这两个基准分支。已尝试在GitVersion.yml中添加默认正则^features?[/-]至feature分支配置，问题仍存在。

当前配置 #

GitVersion.yml #

next-version: 15.0.0 
assembly-informational-format: '{SemVer}'
ignore:
  commits-before: '2021-01-01T00:00:00'
branches:
  develop:
    tag: beta
  feature:
    mode: ContinuousDeployment
    tag: alpha
  release:
    tag: rc
    increment: Minor
    track-merge-target: true
  main:
    track-merge-target: true
  hotfix:
    tag: rc

Pipeline Yml #

trigger:
  branches:
    include:
    - develop
    - releases/*
    - release/*
    - hotfixes/*
    - hotfix/*
    - master
  paths:
    include:
    - src/*

pool:
  vmImage: ubuntu-latest

variables:
  buildConfiguration: 'release'

steps:
- checkout: self
  fetchDepth: 100000
  clean: true
  persistCredentials: true
  
- task: gitversion/setup@0
  displayName: gitversion/setup
  inputs:
    versionSpec: 5.x

- task: gitversion/execute@0
  displayName: gitversion/execute
  inputs:
    useConfigFile: true
    configFilePath: GitVersion.yml

- script: echo "##vso[build.updatebuildnumber]$(GitVersion.SemVer)"

解决方法 #

1. 修正feature分支的正则匹配规则 #

GitVersion默认的feature分支匹配逻辑仅覆盖feature/前缀，无法识别features/开头的分支。需显式指定正则表达式，同时兼容两种分支命名格式：
修改GitVersion.yml中的feature分支配置：

branches:
  # 保留其他分支配置
  feature:
    mode: ContinuousDeployment
    tag: alpha
    regex: ^features?[/-]  # 匹配feature/或features/开头的分支

2. 强制拉取远程基准分支 #

虽然设置了fetchDepth: 100000，但流水线可能未拉取完整的远程分支信息，导致GitVersion无法识别develop和master基准分支。在checkout步骤后添加拉取命令：

- script: |
    git fetch origin develop:develop
    git fetch origin master:master
  displayName: Fetch remote develop and master branches

3. 启用GitVersion动态仓库模式 #

若上述方法无效，可开启动态仓库模式，强制GitVersion从远程仓库获取分支上下文：
修改gitversion/execute@0任务配置：

- task: gitversion/execute@0
  displayName: gitversion/execute
  inputs:
    useConfigFile: true
    configFilePath: GitVersion.yml
    useDynamicRepositories: true  # 开启动态仓库模式

4. 验证分支追踪关系 #

确保feature/features分支基于develop分支创建，且本地仓库正确追踪远程分支。可添加验证步骤排查问题：

- script: |
    git branch -vv
    git log --oneline -n 10
  displayName: Check branch tracking and commit history

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