GitLab CI问题：引入模板中的Rules未正确执行排查

核心原因分析 #

你的问题源于两个关键问题：Rules规则未正确匹配导致任务被错误纳入流水线，以及依赖的build-test-job未在流水线中存在引发报错。具体拆解如下：

1. Rules语法或顺序错误 #

GitLab CI的Rules按顺序匹配，一旦命中第一条满足条件的规则就会停止后续判断。如果模板中规则顺序颠倒，或变量引用错误，会直接导致排除项目的规则失效：

• 错误示例（顺序颠倒）：

  dependency-check-scan-job:
    rules:
      - if: '$CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "master"'
        when: on_success
      - if: '$CI_PROJECT_NAME == "xch-nginx" || $CI_PROJECT_NAME == "xch-vault"'
        when: never
  

  这种情况下，xch-vault项目在main分支运行时，会先匹配到分支规则，直接触发任务执行，完全跳过后续的排除规则。
• 变量引用错误：如果规则中漏写$符号（比如写成CI_PROJECT_NAME == "xch-vault"），会被当作字符串字面量比较，条件永远为假，排除规则自然不生效。

2. 依赖任务缺失 #

当dependency-check-scan-job被错误纳入流水线后，它声明的needs: ["build-test-job"]要求该任务必须存在于当前流水线中。但如果build-test-job本身有规则（比如同样排除xch-vault项目），就会导致依赖任务不存在，触发undefined need报错。

修复步骤 #

1. 修正Rules的顺序与语法 #

将排除项目的规则放在最前面，确保变量引用正确，用单引号包裹条件语句：

dependency-check-scan-job:
  rules:
    - if: '$CI_PROJECT_NAME == "xch-nginx" || $CI_PROJECT_NAME == "xch-vault"'
      when: never
    - if: '$CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "master"'
      when: on_success
  needs: ["build-test-job"]

2. 验证CI变量值 #

添加一个临时调试任务，确认$CI_PROJECT_NAME和$CI_COMMIT_BRANCH的实际值是否符合预期：

debug-ci-vars:
  stage: .pre
  script:
    - echo "项目名称: $CI_PROJECT_NAME"
    - echo "当前分支: $CI_COMMIT_BRANCH"

3. 检查本地配置是否覆盖模板规则 #

确认你的.gitlab-ci.yml中没有重新定义dependency-check-scan-job的Rules，避免本地配置覆盖模板中的排除逻辑。

4. 同步依赖任务的规则 #

如果build-test-job也有项目排除规则，确保它与dependency-check-scan-job的规则一致——要么同时被排除，要么同时被包含，避免出现依赖任务缺失的情况。

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