GitLab中MR自动合并：能否跳过无用流水线阶段？

核心结论 #

完全可以通过配置CI/CD规则，针对仅修改文档的MR跳过业务相关的流水线阶段，同时保留触发Webhook的能力，配合merge_request.merge_when_pipeline_succeeds完成自动合并。

具体操作（以GitLab为例） #

1. 配置流水线规则 #

在项目根目录的.gitlab-ci.yml中添加规则，识别仅修改文档的MR，跳过构建、测试等非必要阶段，只保留文档校验或Webhook触发步骤：

stages:
  - build
  - test
  - docs-validate
  - trigger-webhook

# 业务构建阶段：仅在非文档MR时运行
build:
  stage: build
  script:
    - echo "执行应用构建..."
  rules:
    - if: '$CI_MERGE_REQUEST_CHANGED_FILES =~ /^.*\.(md|rst|txt)$/ && $CI_MERGE_REQUEST_CHANGED_FILES !~ /\.(py|js|java)$/'
      when: never
    - when: always

# 业务测试阶段：仅在非文档MR时运行
test:
  stage: test
  script:
    - echo "执行业务测试..."
  rules:
    - if: '$CI_MERGE_REQUEST_CHANGED_FILES =~ /^.*\.(md|rst|txt)$/ && $CI_MERGE_REQUEST_CHANGED_FILES !~ /\.(py|js|java)$/'
      when: never
    - when: always

# 文档校验阶段：仅在文档MR时运行
docs-validate:
  stage: docs-validate
  script:
    - echo "校验文档格式与链接..."
  rules:
    - if: '$CI_MERGE_REQUEST_CHANGED_FILES =~ /^.*\.(md|rst|txt)$/ && $CI_MERGE_REQUEST_CHANGED_FILES !~ /\.(py|js|java)$/'
      when: always
    - when: never

# Webhook触发阶段：所有MR都运行（满足触发外部通信的要求）
trigger-webhook:
  stage: trigger-webhook
  script:
    - echo "调用外部Webhook接口..."
    # 替换为实际的Webhook调用命令，比如curl
  rules:
    - when: always

2. 配合自动合并推送 #

推送MR时使用merge_request.merge_when_pipeline_succeeds选项，确保精简后的流水线成功后自动合并：

git push origin <你的文档分支>:refs/merge-requests/<MR编号>/head -o merge_request.merge_when_pipeline_succeeds

关键细节 #

• 规则中的文件匹配逻辑可根据项目实际调整，比如只匹配特定目录下的文档（如docs/**/*.md），或忽略某些特殊文档。
• 如果使用GitHub Actions，逻辑类似：通过判断PR修改的文件类型，跳过不必要的job，再启用自动合并功能。
• 这种配置既遵守了"必须通过MR触发Webhook"的限制，又避免了无意义的业务流水线运行，提升效率。

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