GitLab CI/CD调用自定义组件报错：下游流水线未创建原因排查

问题场景与现象 #

我在GitLab CI/CD流水线中新增了调用其他团队开发的自定义组件的任务，根文件.gitlab-ci.yml通过三次包含同一个ci/deploy.gitlab-ci.yml子文件并传入不同参数，实现不同环境的部署触发，组件调用任务放在该子文件内。

遇到的异常：

• 直接调用组件时，收到错误提示："Downstream pipeline not created to call custom component"
• 给该任务添加echo "Hello";语句后，任务可正常执行
• 其他团队确认组件在根文件中调用正常，问题出在当前流水线配置上；尝试将任务移到根文件，但因根文件多次包含子文件的逻辑无法触发组件，只能保留在子文件中

当前流水线配置 #

根文件 .gitlab-ci.yml #

include:
    - local: "ci/deploy.gitlab-ci.yml"
        inputs:
            parameter1: 1
            parameter2: 2
    - local: "ci/deploy.gitlab-ci.yml"
        inputs:
            parameter1: 3
            parameter2: 4
    - local: "ci/deploy.gitlab-ci.yml"
        inputs:
            parameter1: 5
            parameter2: 6

子文件 ci/deploy.gitlab-ci.yml #

*****
stages:
    - deploy
    - test
    - cascade
    - gitguardian-detection
*****
gitguardian-detection:
  stage: gitguardian-detection
  needs: []
  rules:
    # Automatic cascade
    - if: $CI_MERGE_REQUEST_TITLE =~ /^Automatic/
      when: never
    # Validating PR into develop branch
    - if: $CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "develop"
  trigger:
    include:
      # GitGuardian secret detection
      - component: $CI_SERVER_FQDN/doss/ci-components/secrets-scan@~latest
        inputs:
          allow_failure: true
          verbose: true

根因分析 #

• 重复定义Stages导致解析冲突：子文件中重复定义了stages，三次包含后GitLab CI会多次合并阶段配置，可能打乱阶段顺序或导致任务的阶段归属异常，进而影响下游流水线的创建逻辑。添加echo语句后任务变为普通脚本任务，无需创建下游流水线，因此不受该冲突影响。
• 重复任务名称引发的逻辑异常：三次包含子文件后，gitguardian-detection任务被重复定义三次。GitLab CI对重复名称的trigger类任务（需创建下游流水线）处理存在异常，无法正确初始化下游流水线；而普通脚本任务重复定义虽不规范，但不会触发下游流水线创建逻辑，因此能正常执行。
• 重复包含下的变量/上下文冲突：三次包含子文件时，组件调用依赖的$CI_SERVER_FQDN等变量可能在重复解析过程中出现上下文冲突，导致无法正确定位组件地址，进而无法创建下游流水线。添加echo后任务不依赖组件地址解析，因此不受影响。

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