创建Merge Request时GitLab流水线未自动触发的解决咨询

现有流水线配置的核心问题在于：

• sonarqube-check job通过when: never禁止了Merge Request事件触发流水线，导致只有分支推送时才会执行，无法在MR创建阶段自动启动。
• 手动执行git checkout和git pull属于冗余操作，GitLab CI在MR流水线中会自动检出对应的代码版本。
• merge-to-develop使用本地git命令合并推送，绕过了GitLab MR的原生合并流程，可能引发权限、冲突处理和审计日志的问题。

default:
    tags:
        - $RUNNER_TAG

stages:
    - sonarqube
    - merge

# SonarQube扫描：MR创建/更新时自动触发
sonarqube-check:
    stage: sonarqube
    image: node:slim
    cache:
        key: "${CI_JOB_NAME}"
        paths:
            - .sonar/cache
    script:
        - apt-get update -y
        - apt-get install -y git jq
        - yarn install
        - yarn coverage:ci
        - npx sonarqube-scanner -Dproject.settings=./sonar-project-el.properties
        # 获取SonarQube质量门状态
        - PROJECT_KEY=$(grep sonar.projectKey sonar-project-el.properties | cut -d '=' -f2)
        - |
          QUALITY_GATE=$(curl -s -u $SONAR_LOGIN: $SONAR_HOST_URL/api/qualitygates/project_status?projectKey=$PROJECT_KEY | jq -r .projectStatus.status)
          if [ "$QUALITY_GATE" != "OK" ]; then
            echo "SonarQube质量门未通过，MR无法合并。"
            exit 1
          fi
    allow_failure: false
    rules:
        # MR创建或更新时触发，且目标分支为develop
        - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "develop"'
          when: always

# 自动合并MR：质量门通过后执行
merge-to-develop:
    stage: merge
    image: alpine/curl
    script:
        # 使用GitLab API合并MR，而非本地git操作
        - |
          curl --request PUT --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
          "$CI_API_V4_URL/projects/$CI_PROJECT_ID/merge_requests/$CI_MERGE_REQUEST_IID/merge" \
          --data "merge_when_pipeline_succeeds=false"
    rules:
        - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "develop"'
          when: on_success
    needs: ["sonarqube-check"]

• 触发条件调整：将sonarqube-check的规则改为仅在MR事件（创建/更新）且目标分支为develop时触发，删除原有的禁止MR事件规则和分支推送触发规则，确保流水线在MR创建时自动启动。
• 移除冗余操作：删除手动git checkout和git pull步骤，GitLab CI会自动为MR流水线检出合并后的代码，无需手动操作。
• 改用GitLab API合并：替换本地git合并命令为GitLab API调用，遵循MR原生流程，确保权限验证、冲突提示和审计日志完整。需要提前在项目变量中配置GITLAB_API_TOKEN（具备MR合并权限的个人访问令牌）。
• 依赖控制：通过needs确保合并job仅在SonarQube扫描通过后执行。

1. 在GitLab项目设置中，进入合并请求 → 流水线，勾选"只有当流水线成功时才允许合并"，确保质量门未通过时无法手动合并。
2. 确保GITLAB_API_TOKEN变量已添加到项目/组变量中，权限设置为"保护"和"掩码"。

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