GitLab Job未正确继承父Job配置导致Firebase命令缺失

问题原因 #

你遇到的核心问题是：GitLab CI中使用extends继承模板Job时，子Job如果定义了script字段，会完全覆盖父Job的script内容，而非追加执行。

你的e2e:local Job重写了script为- npm run e2e:local，导致.e2e模板里的npm i -g firebase-tools、apt install等前置命令全部没有执行，自然找不到firebase命令。

解决方案 #

推荐两种规范的解决方式：

方式1：使用!reference关键字追加script（GitLab 13.9+支持） #

通过!reference引用父模板的script内容，再追加自己的命令，既保留父Job的逻辑，又能执行子Job的自定义命令：

.e2e:
  stage: 'test'
  image: cypress/base:16.13.0
  script:
    - npm i -g firebase-tools
    - apt update
    - apt -y install default-jre # For firebase emulators
    - apt -y install default-jdk # For firebase emulators
    - firebase use test --token "$FIREBASE_TOKEN"
    - npm ci

e2e:local:
  extends: .e2e
  script:
    - !reference [.e2e, script]
    - npm run e2e:local
  cache:
    key: ${CI_COMMIT_REF_SLUG}
    paths:
      - .npm
      - cache/Cypress
  artifacts:
    paths:
      - cypress/videos
      - cypress/screenshots
    expire_in: 5 day

方式2：拆分通用命令到独立的before_script模板 #

把所有通用前置命令抽成单独的before_script模板，让父Job和子Job继承，避免script字段的覆盖冲突：

.e2e_common:
  before_script:
    - npm i -g firebase-tools
    - apt update
    - apt -y install default-jre # For firebase emulators
    - apt -y install default-jdk # For firebase emulators
    - firebase use test --token "$FIREBASE_TOKEN"
    - npm ci

.e2e:
  stage: 'test'
  image: cypress/base:16.13.0
  extends: .e2e_common

e2e:local:
  extends: .e2e
  script:
    - npm run e2e:local
  cache:
    key: ${CI_COMMIT_REF_SLUG}
    paths:
      - .npm
      - cache/Cypress
  artifacts:
    paths:
      - cypress/videos
      - cypress/screenshots
    expire_in: 5 day

额外优化建议 #

你全局的before_script里有npm i和npm i -g firebase-tools，但.e2e模板里已经用了npm ci（比npm i更适合CI环境），且全局安装的工具可能存在PATH环境变量问题，建议移除全局before_script中的这两行，统一用模板内的逻辑，避免冗余和潜在冲突。

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