推送至GitLab master分支无PR时流水线报错“未找到相关合并请求”

问题概述 #

在master分支推送包含src/lib/api-proxy/package-lock.json的代码修改后，GitLab流水线执行失败，报错“未找到相关合并请求”。当前父级.gitlab-ci.yml的trigger_api配置预期会触发子流水线重建：

trigger_api:
  stage: triggers
  trigger:
    include: src/.gitlab-ci.yml
    strategy: depend
  rules:
    - changes:
      - src/lib/**/*
      - src/api-proxy-lambda/**/*

子流水线src/.gitlab-ci.yml配置如下：

build-lib-api-proxy:
  stage: build
  image: node:alpine
  script:
    - cd src/lib/api-proxy
    - npm install --verbose
    - npm run build
  cache:
    paths:
      - lib/api-proxy/node_modules/
  rules:
    - when: on_success

可能原因及解决方法 #

1. 子流水线规则未适配分支推送场景 #

子流水线中rules: - when: on_success未明确限定触发场景，若项目其他配置隐含依赖合并请求上下文，master分支直接推送时会因无合并请求信息报错。

修改方案：给子流水线的规则添加分支或触发源判断，适配直接推送场景：

build-lib-api-proxy:
  stage: build
  image: node:alpine
  script:
    - cd src/lib/api-proxy
    - npm install --verbose
    - npm run build
  cache:
    paths:
      - lib/api-proxy/node_modules/
  rules:
    - if: $CI_COMMIT_BRANCH == 'master'
      when: on_success
    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
      when: on_success

2. CI配置中隐含合并请求变量依赖 #

排查所有CI配置文件，确认是否使用了$CI_MERGE_REQUEST_ID、$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME等仅在合并请求流水线中存在的变量。这些变量在master分支直接推送的流水线中不存在，会导致“未找到相关合并请求”类错误。

解决方法：移除不必要的合并请求变量依赖，或给依赖这些变量的逻辑添加条件判断，比如：

# 示例：仅在合并请求流水线中执行相关逻辑
- if: $CI_PIPELINE_SOURCE == 'merge_request_event'
  script:
    - echo "处理合并请求逻辑"

3. 父流水线触发验证 #

确认trigger_api job是否实际被触发：

• 进入GitLab流水线页面，查看该job的执行状态；
• 若未触发，检查文件路径匹配是否存在问题（比如文件被.gitignore排除，或CI变更检测逻辑异常），可尝试手动触发流水线验证。

4. 定位报错来源 #

查看流水线失败的具体job日志，确认报错来自父流水线的trigger步骤还是子流水线的build步骤，精准定位需要合并请求上下文的代码或命令，针对性修复。

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