TeamCity+Docker环境下SonarQube SCM识别及PR装饰失败求助

API 探路者

2026-9-26

问题根因

Docker构建上下文隔离：Sonar分析命令执行在Docker镜像构建流程内，默认无法直接访问TeamCity宿主机的检出目录。你传入的sonar.projectBaseDir是宿主机路径/home/tcservice/buildAgent/work/59055310711a86a1，该路径在容器构建环境中不存在对应的.git目录，因此触发非git工作树的报错。
.git目录被过滤：多数项目的.dockerignore文件会默认排除.git目录，导致Docker构建上下文根本没有携带.git文件，Sonar自然无法识别SCM信息。
组件版本适配缺陷：SonarScanner for MSBuild 4.8版本与SonarQube 9.1的SCM检测逻辑存在已知适配问题，容器化运行场景下的git路径识别兼容性较差。

解决步骤

调整Docker构建上下文规则
首先打开项目根目录的.dockerignore文件，删除所有.git相关的过滤规则，确保.git目录会被纳入Docker构建上下文。
执行docker build命令时，将上下文路径指定为TeamCity的检出根目录（即包含.git的目录），示例命令：

docker build -f ./src/Dockerfile %teamcity.build.checkoutDir%

修正Dockerfile内的Sonar配置
在Dockerfile中复制代码的步骤之后，将工作目录切换到容器内的代码根目录，同时调整Sonar参数的路径指向容器内路径，示例配置：

# 复制构建上下文的所有内容（包含.git）到容器内/app目录
COPY . /app
WORKDIR /app

# 执行Sonar分析，删除原宿主机路径的projectBaseDir参数，替换为容器内路径
RUN dotnet sonarscanner begin /k:"你的项目key" /d:sonar.host.url="你的Sonar地址" /d:sonar.login="你的token" /d:sonar.scm.provider=git /d:sonar.projectBaseDir=/app
RUN dotnet build
RUN dotnet sonarscanner end /d:sonar.login="你的token"

补充PR装饰所需的版本参数
将TeamCity的VCS信息通过构建参数传入Docker构建过程，解决无revision信息的问题：

TeamCity端执行docker build时添加构建参数：

docker build \
--build-arg SONAR_REVISION=%build.vcs.number% \
--build-arg SONAR_PR_KEY=%teamcity.pullRequest.number% \
--build-arg SONAR_PR_SOURCE=%teamcity.pullRequest.source.branch% \
--build-arg SONAR_PR_TARGET=%teamcity.pullRequest.target.branch% \
-f ./src/Dockerfile %teamcity.build.checkoutDir%

Dockerfile中接收参数并传递给Sonar：

ARG SONAR_REVISION
ARG SONAR_PR_KEY
ARG SONAR_PR_SOURCE
ARG SONAR_PR_TARGET

RUN dotnet sonarscanner begin /k:"你的项目key" /d:sonar.host.url="你的Sonar地址" /d:sonar.login="你的token" /d:sonar.scm.provider=git /d:sonar.projectBaseDir=/app /d:sonar.scm.revision=${SONAR_REVISION} /d:sonar.pullrequest.key=${SONAR_PR_KEY} /d:sonar.pullrequest.branch=${SONAR_PR_SOURCE} /d:sonar.pullrequest.base=${SONAR_PR_TARGET}

可选兼容优化
如果上述步骤执行后仍有SCM识别问题，将TeamCity内置的SonarScanner for MSBuild升级到5.0以上版本，适配SonarQube 9.1的API规则。

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