Sonar 7.0执行Maven扫描失败：解析bootstrap index出错求助

这个错误提示说明Sonar Maven插件在尝试和SonarQube服务器通信时，拿到的不是预期的API响应，而是HTML内容（比如错误页面、登录页或者代理拦截页），下面是几个大概率能解决问题的排查方向：

1. 检查插件版本与SonarQube 7.0的兼容性 #

你当前用的3.4.0.905版本的插件，和SonarQube 7.0可能存在兼容性问题——不同版本的SonarQube对扫描器插件的版本有明确要求，版本不匹配会导致通信异常，返回非预期的HTML内容。

推荐你换成SonarQube 7.0官方推荐的插件版本，比如3.2.0.1227，修改pom.xml中的插件配置：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>3.2.0.1227</version>
</plugin>

另外注意：现在Sonar官方更推荐使用org.sonarsource.scanner.maven作为groupId的插件（你错误日志里显示的就是这个groupId），如果之前用的是社区维护的org.codehaus.mojo，可以考虑切换成官方版本，配置如下：

<plugin>
    <groupId>org.sonarsource.scanner.maven</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>3.2.0.1227</version>
</plugin>

2. 确认SonarQube服务器地址配置正确 #

如果插件找不到正确的SonarQube服务器地址，请求会返回404或其他HTML错误页面，导致解析失败。你可以通过两种方式配置：

• 在pom.xml中添加Sonar属性：

  <properties>
      <sonar.host.url>http://你的Sonar服务器地址:9000</sonar.host.url>
  </properties>
  

• 或者在执行命令时直接指定：

  mvn clean install sonar:sonar -X -Dsonar.host.url=http://你的Sonar服务器地址:9000
  

配置后先手动访问这个地址，确认能正常打开SonarQube的页面，同时确保服务器处于运行状态。

3. 排查网络/代理问题 #

如果你的环境需要通过代理访问SonarQube服务器，但Maven没有配置正确的代理，请求会被拦截并返回代理的HTML提示页。此时需要在Maven的settings.xml中配置代理：

<proxies>
    <proxy>
        <id>company-proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>你的代理地址</host>
        <port>代理端口</port>
        <nonProxyHosts>localhost|127.0.0.1|*.你的内网域名</nonProxyHosts>
    </proxy>
</proxies>

如果不需要代理，检查是否有系统级的代理设置影响，临时关闭后再尝试执行命令。

4. 检查SonarQube服务器状态 #

SonarQube 7.0服务器可能没有完全启动，或者出现内部错误，导致返回HTML错误页面。你可以：

• 重启SonarQube服务器，等待日志中出现类似"SonarQube is up and running"的提示后再执行扫描。
• 查看SonarQube的日志文件（通常在sonarqube-7.0/logs目录下的web.log），排查是否有服务器启动失败或报错的信息。

先从版本兼容和服务器地址这两个最常见的问题开始排查，一般都能解决这个解析错误。

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