Gitlab CI/CD合并请求创建或代码变更时不自动触发的解决方法咨询

以下是排查和解决的核心步骤：

1. 修正.gitlab-ci.yml的触发规则 #

这是最常见的问题根源——你的流水线配置可能限制了仅手动触发。检查配置文件中的rules或only/except块，确保包含推送（push）和合并请求（merge request）的触发条件。

错误示例（仅手动触发）： #

build_job:
  script:
    - npm run build
  only:
    - manual

正确配置（支持自动触发推送和MR）： #

使用rules（推荐，更灵活）：

build_job:
  script:
    - npm run build
  rules:
    - if: $CI_PIPELINE_SOURCE == "push"
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

或者使用only/except（旧语法，仍兼容）：

build_job:
  script:
    - npm run build
  only:
    - pushes
    - merge_requests

注意：rules优先级高于only/except，如果配置中同时存在，only/except会被忽略。

2. 检查项目CI/CD全局设置 #

• 进入项目Settings → CI/CD → General pipelines
  • 确认CI/CD configuration file路径正确（默认是根目录的.gitlab-ci.yml，如果配置文件在子目录，需指定完整路径）
  • 确保未勾选**"Skip pipelines for duplicate commits"**（除非你确实需要重复提交跳过，但这会导致部分推送不触发流水线）
• 进入Settings → CI/CD → Runners，确认有处于Active状态的可用Runner，且Runner的标签与你job中指定的tags匹配（如果job设置了tags）。Runner离线或标签不匹配会导致流水线处于Pending状态，看似未触发。

3. 验证分支保护与用户权限 #

• 进入项目Settings → Repository → Protected branches，检查目标分支的权限设置：
  • 确保推送代码的用户在Allowed to push列表中
  • 确认未设置"禁止触发流水线"的特殊限制（默认无此限制，但部分自定义配置可能存在）

4. 检查提交信息与MR选项 #

• 查看开发者的提交信息，是否包含[ci skip]或[skip ci]关键词——GitLab会自动跳过带有这些标记的提交的流水线
• 合并请求创建时，是否勾选了**"Do not start pipeline"**选项？该选项会直接阻止MR触发流水线，需提醒开发者避免勾选。

5. 排查GitLab实例级限制 #

如果以上步骤都无效，可能是GitLab实例的管理员设置了全局限制：

• 检查是否有全局的CI/CD规则阻止了自动触发
• 确认实例的Runner资源是否充足，没有出现队列阻塞的情况

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