使用treeless fetch为SonarQube获取提交历史时遇SHA获取错误求助

问题原因 #

使用fetchFilter: tree:0启用treeless fetch后，Git仅拉取提交历史（commit objects），不会拉取文件内容（tree/blob objects）。当SonarQube执行blame操作需要访问文件内容时，Git会尝试从promisor远程（即Azure DevOps仓库）按需拉取对应的SHA，但由于Azure DevOps托管代理的环境限制、Git LFS配置冲突或仓库权限设置，导致拉取失败，抛出该错误。

可行解决方案 #

1. 放弃treeless fetch，改用完整历史拉取 #

如果仓库体积允许，直接移除fetchFilter: tree:0配置，改为拉取完整的提交历史与文件内容，确保SonarQube能直接访问所需的文件数据：

steps:
- checkout: self
  clean: true
  fetchDepth: 0  # 拉取完整提交历史

2. 配置Git允许从promisor远程按需拉取 #

若仍想保留treeless fetch以节省带宽，可在checkout步骤后添加脚本，配置Git的promisor远程参数，确保能正常拉取所需的blob对象：

steps:
- checkout: self
  clean: true
  fetchFilter: tree:0

- script: |
    git config remote.origin.promisor true
    git config remote.origin.partialclonefilter tree:0
    git fetch --update-shallow
  displayName: 'Configure Git promisor remote'

3. 排除Git LFS影响（针对LFS仓库） #

如果仓库使用Git LFS，当前版本的Git LFS（3.4.0）可能与treeless fetch存在兼容性问题。可尝试在checkout步骤中禁用LFS：

steps:
- checkout: self
  clean: true
  fetchFilter: tree:0
  lfs: false  # 禁用LFS拉取

4. 临时调整SonarQube blame配置（应急方案） #

若上述方法无效，可在SonarQube扫描步骤中临时禁用blame功能，避免触发SHA拉取操作：

- task: SonarQubeAnalyze@5
  inputs:
    jdkversion: '17'
    extraProperties: |
      sonar.blame.disabled=true

验证步骤 #

1. 重新运行流水线，检查是否仍出现SHA拉取错误
2. 确认SonarQube的代码分析功能正常，blame信息（若启用）能正确显示

内容的提问来源于stack exchange，提问作者N.Y