GitLab CI自动合并MR偶发失败：分支无法合并，重试恢复

核心问题根源 #

1. Rebase异步执行延迟：GitLab的rebase API是异步调用，触发后立刻返回响应，但实际rebase操作仍在后台运行。此时直接执行合并，分支还处于未就绪状态，就会抛出Branch cannot be merged错误。
2. Merge Train资源锁定：当项目启用Merge Train时，若其他MR正在Train中处理，目标分支会被临时锁定，当前MR的合并操作会被阻塞。重试时Train已释放资源，操作即可成功。

具体修复方案 #

1. 等待Rebase完成后再合并 #

在调用rebase API后，通过轮询MR的状态字段，确认rebase彻底完成再执行合并：

# 触发rebase后添加轮询逻辑
$rebaseUrl = "$($env:CI_API_V4_URL)/projects/$($env:CI_PROJECT_ID)/merge_requests/$($env:CI_MERGE_REQUEST_IID)/rebase"
Invoke-RestMethod -Uri $rebaseUrl -Method Put -Headers $headers

# 轮询等待rebase结束
$mrStatusUrl = "$($env:CI_API_V4_URL)/projects/$($env:CI_PROJECT_ID)/merge_requests/$($env:CI_MERGE_REQUEST_IID)"
do {
    Start-Sleep -Seconds 5
    $mrStatus = Invoke-RestMethod -Uri $mrStatusUrl -Method Get -Headers $headers
    Write-Output "Rebase进度: $($mrStatus.rebase_in_progress)"
} while ($mrStatus.rebase_in_progress -eq $true)

# 检查rebase是否成功
if ($mrStatus.merge_status -ne "can_be_merged") {
    Write-Error "Rebase失败，当前合并状态: $($mrStatus.merge_status)"
    exit 1
}

2. 给合并操作加重试机制 #

针对Merge Train导致的临时锁定，添加自动重试逻辑，失败后等待一段时间再重试：

if ($mrTitle -match "#force_mr") {
    Write-Output "检测到标题关键词，尝试合并..."
    $mergeUrl = "$($env:CI_API_V4_URL)/projects/$($env:CI_PROJECT_ID)/merge_requests/$($env:CI_MERGE_REQUEST_IID)/merge"
    
    # 最多重试3次，每次间隔10秒
    $retryCount = 0
    $maxRetries = 3
    $mergeSuccess = $false
    
    while ($retryCount -lt $maxRetries -and $mergeSuccess -eq $false) {
        try {
            Invoke-RestMethod -Uri $mergeUrl -Method Put -Headers $headers
            $mergeSuccess = $true
            Write-Output "合并成功"
        } catch {
            $retryCount++
            Write-Output "合并失败，第$retryCount次重试。错误信息: $_"
            Start-Sleep -Seconds 10
        }
    }
    
    if (-not $mergeSuccess) {
        Write-Error "已重试$maxRetries次，合并仍失败"
        exit 1
    }
} else {
    Write-Output "未检测到标题关键词，跳过合并"
}

3. 项目配置优化 #

• 若项目启用Merge Train，在项目设置 > Merge Requests > Merge Train中，勾选「只有当流水线成功时才加入Merge Train」，确保当前MR的CI完成后再进入Train，减少冲突概率。
• 保持when: on_success配置，确保前置阶段全部成功后才执行该工作流，避免提前触发操作。

完整优化后的CI脚本 #

auto_mr_check:
  stage: auto_check
  tags:
    - windows
  script:
    - |
      $headers = @{
        "PRIVATE-TOKEN" = "$env:GITLAB_TOKEN" # 用CI/CD变量存储token，不要硬编码
      }
      $mrTitle = $env:CI_MERGE_REQUEST_TITLE
      Write-Output "Merge Request标题: $mrTitle"
      
      $mrStatusUrl = "$($env:CI_API_V4_URL)/projects/$($env:CI_PROJECT_ID)/merge_requests/$($env:CI_MERGE_REQUEST_IID)"
      $rebaseUrl = "$mrStatusUrl/rebase"
      
      # 触发rebase
      Invoke-RestMethod -Uri $rebaseUrl -Method Put -Headers $headers
      
      # 等待rebase完成
      do {
          Start-Sleep -Seconds 5
          $mrStatus = Invoke-RestMethod -Uri $mrStatusUrl -Method Get -Headers $headers
          Write-Output "Rebase进行中: $($mrStatus.rebase_in_progress) | 合并状态: $($mrStatus.merge_status)"
      } while ($mrStatus.rebase_in_progress -eq $true)
      
      # 检查rebase结果
      if ($mrStatus.merge_status -ne "can_be_merged") {
          Write-Error "Rebase失败，当前合并状态为$($mrStatus.merge_status)"
          exit 1
      }
      
      if ($mrTitle -match "#force_mr") {
          Write-Output "检测到标题关键词，尝试合并..."
          $mergeUrl = "$mrStatusUrl/merge"
          
          # 合并重试逻辑
          $retryCount = 0
          $maxRetries = 3
          $mergeSuccess = $false
          
          while ($retryCount -lt $maxRetries -and $mergeSuccess -eq $false) {
              try {
                  Invoke-RestMethod -Uri $mergeUrl -Method Put -Headers $headers
                  $mergeSuccess = $true
                  Write-Output "合并成功"
              } catch {
                  $retryCount++
                  Write-Output "合并失败，第$retryCount次重试。错误信息: $($_.Exception.Message)"
                  Start-Sleep -Seconds 10
              }
          }
          
          if (-not $mergeSuccess) {
              Write-Error "已重试$maxRetries次，合并仍失败"
              exit 1
          }
      } else {
          Write-Output "未检测到标题关键词，跳过合并"
      }
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      when: on_success
  variables:
    GIT_STRATEGY: none # 无需克隆仓库

额外注意事项 #

• 不要硬编码token，在GitLab项目的CI/CD > 变量中添加GITLAB_TOKEN，并设置为「保护变量」避免泄露。
• 可根据项目大小调整轮询间隔（比如大型项目设为10秒）和重试次数（比如增加到5次），适配实际的rebase/merge耗时。

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