python-gitlab创建MR后无法获取实时MR状态信息问题

数据老陈

2026-8-27

问题描述

使用python-gitlab库创建合并请求（MR）后，需要检查MR是否存在冲突、关联流水线（pipeline）的运行状态，初始实现代码如下：

project = gl.projects.get(PROJECT_ID, lazy=False)
create_mr = project.mergerequests.create({'id': PROJECT_ID,
                                      'title': 'Testing multiMR',
                                      'source_branch': SOURCE_BRANCH,
                                      'target_branch': TARGET_BRANCH,
                                      'labels': [LABEL]})
mr_iid = getattr(create_mr, 'iid')

time.sleep(3)

get_mr = project.mergerequests.get(mr_iid)
mr_conflict = getattr(get_mr, 'has_conflicts')
mr_pipeline = getattr(get_mr, 'pipeline', 'No pipeline')

上述逻辑无法获取实时准确的信息，返回的数据仅为MR刚创建时的初始状态，不包含冲突、pipeline相关的有效信息。在其他控制台单独运行仅检查MR状态的脚本时，可以获取到正确的实时信息。
后续尝试在创建MR的脚本中增加循环等待、刷新项目信息后重新查询的逻辑，代码如下：

n = 4
while n > 0: 
  
  time.sleep(1)
  n -= 1
  project.refresh()
  get_mr = project.mergerequests.get(mr_iid)
  mr_conflict = get_mr.has_conflicts
  mr_pipeline = getattr(get_mr, 'pipeline', 'No pipeline')

即使增加了等待和项目刷新逻辑，依然无法获取到更新后的MR信息。需要实现在创建MR的同一脚本内获取MR实时状态信息。

问题原因

GitLab服务端创建MR后，冲突检测、pipeline触发都是后端异步执行的任务，刚创建完MR的前几秒，服务端还没完成这些计算，自然查不到有效数据
之前代码里刷新的是project对象，对MR对象的本地缓存没有影响，直接读取MR属性拿到的是首次拉取时的旧数据
普通MR信息接口返回的has_conflicts字段本身存在更新延迟，不是实时计算的结果

解决方案

按照以下逻辑调整即可拿到实时数据：

轮询时不要刷新project对象，直接对MR实例调用refresh()方法，强制从GitLab服务端拉取最新的MR数据，清除本地缓存
不要直接读取has_conflicts属性，调用MR实例的conflicts()方法，这个方法对接GitLab专用的实时冲突检查接口，返回结果无延迟
拉长轮询等待窗口，适配GitLab异步任务的处理速度，建议设置最长等待30秒，每2秒轮询一次
关联pipeline存在生成延迟，轮询周期内如果没查到pipeline不要直接返回无结果，等轮询结束后再做兜底判断

调整后的可运行代码如下：

import time

project = gl.projects.get(PROJECT_ID, lazy=False)
create_mr = project.mergerequests.create({
    'title': 'Testing multiMR',
    'source_branch': SOURCE_BRANCH,
    'target_branch': TARGET_BRANCH,
    'labels': [LABEL]
})
mr_iid = create_mr.iid
mr = project.mergerequests.get(mr_iid)

# 轮询配置：最长等待30秒，每次间隔2秒
max_wait_seconds = 30
poll_interval = 2
elapsed_seconds = 0
mr_conflict = None
mr_pipeline = "No pipeline"

while elapsed_seconds < max_wait_seconds:
    # 强制刷新MR的最新数据
    mr.refresh()
    # 调用专用接口获取实时冲突状态
    conflict_result = mr.conflicts()
    mr_conflict = conflict_result.get("has_conflicts", False)
    
    # 检查是否已生成关联pipeline
    if mr.pipeline:
        mr_pipeline = mr.pipeline
        # 如果需要等pipeline跑出初始状态，可以加判断：mr.pipeline.get("status") not in ["created", "pending"] 再break
        break
    
    time.sleep(poll_interval)
    elapsed_seconds += poll_interval

# 后续可自行编写mr_conflict、mr_pipeline相关的业务处理逻辑

注意：如果你的GitLab实例负载比较高，异步任务处理慢，可以适当把最长等待时间调到60秒，避免提前终止轮询拿不到结果。

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