Azure DevOps流水线自动合并分支报错解决及流程实现问询

你遇到的推送报错（错误码128）由两个问题导致：

1. Azure DevOps默认分配给流水线的构建服务账号仅拥有仓库的读取权限，无代码推送权限
2. 流水线默认不会持久化git访问凭证，执行git push时需要交互输入密码，而非交互模式禁止终端弹窗，因此直接报错

1. 配置仓库权限：进入对应项目的「项目设置」->「仓库」->选中你的目标仓库->「安全性」，搜索Project Collection Build Service (你的组织名称)账号，为其分配以下权限：
   • 贡献
   • 绕过分支策略时执行推送（如果你的main分支配置了必须PR才能合并的分支策略，需要开启此权限，否则可忽略）
2. 配置流水线检出参数：后续流水线的检出步骤需要开启凭证持久化，并且设置全量拉取代码，避免浅克隆导致分支找不到的问题

以下是适配Windows代理、符合你需求的完整YAML配置：

# 关闭手动/代码提交触发，仅保留定时触发
trigger: none
pr: none

# 定时触发配置，示例为每天凌晨2点执行，可自行修改cron表达式
schedules:
- cron: "0 2 * * *"
  displayName: 每日凌晨2点合并develop到main
  branches:
    include:
    - develop
  always: true # 设为true则无论develop是否有代码变更都执行，false则仅当有新变更时执行

pool:
  vmImage: 'windows-latest' # 可替换为你自己的私有Windows代理池

steps:
- checkout: self
  fetchDepth: 0 # 全量拉取代码，否则无法找到全部分支
  persistCredentials: true # 持久化git访问凭证，解决push时的认证问题

# 步骤1：检查develop分支最新构建状态是否成功
- task: PowerShell@2
  displayName: 检查develop分支最新构建状态
  inputs:
    targetType: 'inline'
    script: |
      $header = @{
          Authorization = "Bearer $(System.AccessToken)"
      }
      # 调用Azure DevOps API获取develop分支最近一次构建结果
      $url = "$(System.CollectionUri)$(System.TeamProject)/_apis/build/builds?definitions=$(System.DefinitionId)&branchName=refs/heads/develop&`$top=1&api-version=7.1-preview.7"
      $response = Invoke-RestMethod -Uri $url -Headers $header -Method Get
      $latestBuildResult = $response.value[0].result
      
      if ($latestBuildResult -ne "succeeded") {
          Write-Host "##vso[task.logissue type=error]develop分支最新构建未成功，终止合并流程，最新构建结果：$latestBuildResult"
          exit 1
      }
      Write-Host "develop分支最新构建状态为成功，继续执行合并流程"

# 步骤2：执行合并操作
- task: CmdLine@2
  displayName: 合并develop到main分支
  inputs:
    script: |
      cd s
      :: 配置git用户信息，避免提交时无身份报错
      git config user.name "Azure DevOps Build Service"
      git config user.email "devops@yourorg.com"
      :: 切换到main分支并拉取最新代码
      git checkout main
      git pull origin main
      :: 合并develop分支，有冲突时自动失败
      git merge origin/develop --no-edit
      if %errorlevel% neq 0 (
          echo 合并出现冲突，流水线终止
          exit 1
      )

# 步骤3：推送合并后的代码到远程仓库
- task: CmdLine@2
  displayName: 推送合并结果到main分支
  inputs:
    script: |
      cd s
      git push origin main

• 如果需要强制生成合并提交便于追溯，可以将git merge origin/develop --no-edit改为git merge origin/develop --no-edit --no-ff
• 如果仅允许快进合并，可以在merge命令后加--ff-only参数，避免生成多余的合并提交
• 定时触发的cron表达式为UTC时间，需要根据你的时区自行调整偏移量

• 若你的main分支配置了代码评审、构建校验等分支策略，要么给构建服务账号开绕过权限，要么将自动合并流程调整为自动创建PR走正常的分支策略校验流程
• 建议第一次运行前先手动执行一遍流程，确认权限配置正确
• 合并失败时流水线会直接报错终止，你可以配置告警规则接收合并失败的通知

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