GitLab CI中Nx偶尔使用错误提交引用的问题求助

问题背景 #

在单体Nx仓库的GitLab CI流水线中，linting作业偶尔会因无效提交引用失败，报错提示找不到指定的commit SHA。当前设置基准提交的脚本如下：

- if [ "$CI_PIPELINE_SOURCE" == "merge_request_event" ]; then NX_BASE=${CI_MERGE_REQUEST_DIFF_BASE_SHA:-$CI_COMMIT_BEFORE_SHA}; else NX_BASE=HEAD~1; fi
- NX_HEAD=HEAD

执行的lint命令：

npx nx affected --base=$NX_BASE --head=$NX_HEAD --target=lint --parallel=3

错误输出示例：

$ if [ "$CI_PIPELINE_SOURCE" == "merge_request_event" ]; then NX_BASE=${CI_MERGE_REQUEST_DIFF_BASE_SHA:-$CI_COMMIT_BEFORE_SHA}; else NX_BASE=HEAD~1; fi
$ NX_HEAD=HEAD
$ git show-ref
baf7d995796d6cda3e67e1c8dafe3952d875aa19 refs/pipelines/35035
$ npx nx affected --base=$NX_BASE --head=$NX_HEAD --target=lint --parallel=3
fatal: Not a valid commit name 9e27db2e2ae932d0cdcc7a4a04eddb84201ad045
fatal: No such ref: '9e27db2e2ae932d0cdcc7a4a04eddb84201ad045'

核心原因 #

问题根源是GitLab CI默认的浅克隆策略：流水线运行时本地仓库仅拉取极少的提交历史，脚本中指定的NX_BASE（如CI_MERGE_REQUEST_DIFF_BASE_SHA或HEAD~1）对应的提交并未被同步到本地，导致Git无法识别该引用。

解决方案 #

1. 拉取足够的提交历史 #

在流水线的before_script中添加Git拉取命令，确保本地仓库包含基准提交：

before_script:
  # 尝试解除浅克隆，失败则拉取最近100条提交历史
  - git fetch --unshallow || git fetch --depth=100
  # MR场景下，额外拉取基准提交的完整引用
  - if [ "$CI_PIPELINE_SOURCE" == "merge_request_event" ]; then git fetch origin $CI_MERGE_REQUEST_DIFF_BASE_SHA; fi

2. 增加基准提交的有效性校验 #

修改NX_BASE的设置逻辑，校验提交是否存在，不存在则自动 fallback 到可靠分支（如MR目标分支或仓库默认分支）：

script:
  - |
    if [ "$CI_PIPELINE_SOURCE" == "merge_request_event" ]; then
      # 优先使用MR差异基准SHA， fallback到CI_COMMIT_BEFORE_SHA
      NX_BASE=${CI_MERGE_REQUEST_DIFF_BASE_SHA:-$CI_COMMIT_BEFORE_SHA}
      # 校验提交是否存在，不存在则用MR目标分支的远程引用
      if ! git rev-parse --verify "$NX_BASE" >/dev/null 2>&1; then
        NX_BASE="origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME"
      fi
    else
      # 非MR场景下优先用HEAD~1，不存在则用默认分支的远程引用
      NX_BASE=HEAD~1
      if ! git rev-parse --verify "$NX_BASE" >/dev/null 2>&1; then
        NX_BASE="origin/$CI_DEFAULT_BRANCH"
      fi
    fi
  - NX_HEAD=HEAD
  - npx nx affected --base=$NX_BASE --head=$NX_HEAD --target=lint --parallel=3

3. 可选：直接使用远程分支作为基准 #

如果不需要精确到单个提交，也可以在MR场景下直接用目标分支作为基准，彻底避免SHA不存在的问题：

script:
  - |
    if [ "$CI_PIPELINE_SOURCE" == "merge_request_event" ]; then
      NX_BASE="origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME"
    else
      NX_BASE="origin/$CI_DEFAULT_BRANCH"
    fi
  - NX_HEAD=HEAD
  - npx nx affected --base=$NX_BASE --head=$NX_HEAD --target=lint --parallel=3

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