Docker部署SonarQube执行Maven扫描时返回401错误的排查与解决

看起来你遇到的核心问题是**Maven Sonar扫描请求默认跑到SonarCloud（而非你本地Docker部署的SonarQube）**上了，导致你生成的本地SonarQube Token无法在SonarCloud上验证，从而返回401权限错误。咱们一步步来排查解决：

1. 强制指定SonarQube地址与Token（快速验证） #

首先可以通过Maven命令行显式指定目标SonarQube地址和Token，绕过配置文件可能的读取问题，执行以下命令试试：

mvn clean verify sonar:sonar -Dsonar.host.url=http://localhost:9000 -Dsonar.token=你的实际Token

这样能直接确保扫描请求发送到你本地的SonarQube服务，而不是默认的SonarCloud。

2. 检查sonar-project.properties配置的有效性 #

• 确保这个文件放在项目根目录（和pom.xml同一层级），Maven默认会从这个位置读取配置
• 检查文件里的sonar.host.url是否确实是http://localhost:9000，有没有拼写错误（比如多写了s变成https，或者端口不对）
• 确认sonar.token的值和你在本地SonarQube生成的Token完全一致，不要有多余的空格或换行

3. 确认本地SonarQube服务正常运行 #

• 先用docker-compose ps查看sonarqube容器的状态，确保它是Up状态
• 直接访问http://localhost:9000，确认SonarQube页面能正常打开，并且你能用生成Token的账号登录
• 查看SonarQube容器日志，检查是否有数据库连接或启动错误：

  docker logs sonarqube
  

4. 优化Maven插件配置（可选，避免配置冲突） #

你的pom.xml里只声明了Sonar插件，但没有指定SonarQube地址，Maven会 fallback 到默认的SonarCloud地址。可以在插件里添加配置，确保默认指向本地服务（注意不要把Token硬编码到pom.xml，更推荐命令行或配置文件方式）：

<plugin>
    <groupId>org.sonarsource.scanner.maven</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>${sonar-maven-plugin.version}</version>
    <configuration>
        <sonar.host.url>http://localhost:9000</sonar.host.url>
    </configuration>
</plugin>

5. 排查网络与权限问题 #

• 如果是Windows系统，确认本地防火墙没有拦截9000端口的请求
• 确保你生成的Token在本地SonarQube的个人账号→安全页面中存在且未过期，Token的权限至少包含项目分析权限

备注：内容来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu