GitLab流水线重复包含子文件仅执行最后一个实例问题排查

核心原因 #

GitLab CI的Job遵循同名覆盖规则：如果多个Job拥有相同的名称，后续定义的Job会完全覆盖之前的。你三次引入同一个子文件，子文件内的display阶段Job名称是固定的，每次引入都会重新定义这个Job，最终只有第三次引入的版本被保留，前两次的Job被直接覆盖，自然不会执行也看不到日志。

解决方案 #

1. 用模板继承创建唯一命名的Job #

把子文件中的Job定义为模板Job（名称以.开头，不会直接执行），然后在主文件中创建不同名称的Job继承这个模板，同时传入对应变量：

# ci/deploy.gitlab-ci.yml
# 定义模板Job（前缀为.，不会自动执行）
.display_template:
  stage: display
  script:
    - echo "当前分支: $branch"
    - echo "是否运行全量Apex测试: $run_all_apex_tests"

# .gitlab-ci.yml
include:
  - local: ci/deploy.gitlab-ci.yml

# 为每个分支创建独立Job
display_develop:
  extends: .display_template
  variables:
    branch: develop
    run_all_apex_tests: "true"

display_release_137:
  extends: .display_template
  variables:
    branch: release/1.37

display_master:
  extends: .display_template
  variables:
    branch: master

2. 给引入的Job添加唯一前缀（GitLab 13.9+） #

利用include的job-name-prefix参数，给每次引入的子文件Job添加专属前缀，避免名称冲突：

# .gitlab-ci.yml
include:
  - local: ci/deploy.gitlab-ci.yml
    job-name-prefix: "develop_"
    variables:
      branch: develop
      run_all_apex_tests: "true"
  - local: ci/deploy.gitlab-ci.yml
    job-name-prefix: "release_"
    variables:
      branch: release/1.37
  - local: ci/deploy.gitlab-ci.yml
    job-name-prefix: "master_"
    variables:
      branch: master

这样子文件中的display Job会被分别命名为develop_display、release_display、master_display，彼此独立不会覆盖，都会执行并生成日志。

3. 验证阶段配置 #

确保主文件中stages列表包含display阶段（如果子文件未定义stages），不过因为第三次Job能正常执行，这个问题的概率较低，但可以快速检查排除：

# .gitlab-ci.yml
stages:
  - display
  # 其他阶段...

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