SonarQube GitHub Actions报错：服务器不可达、容器action仅支持Linux

两个报错的根本原因 #

• 托管runner（ubuntu-latest）连接失败：SONAR_HOST_URL 配置为 http://localhost:9000 是无效配置。GitHub 官方托管 runner 运行在微软云端服务器环境，localhost 指向 runner 自身的回环地址，该环境内没有部署 SonarQube 服务，自然无法连接。
• Windows 自托管runner 报容器不兼容：官方 sonarsource/sonarqube-scan-action@master 是基于 Linux 容器封装的 action，Windows 系统的 runner 不支持运行 Linux 容器类 action，属于平台硬性限制。

可落地修复方案 #

根据你的部署场景二选一即可：

方案1：保留本地部署的SonarQube，使用Linux自托管runner #

• 准备Linux环境作为自托管runner节点：物理Linux机、本地Linux虚拟机、Windows上的WSL2环境都满足要求，在该节点上完成GitHub self-hosted runner的部署注册。
• 保证该Linux runner节点和你本地的SonarQube服务网络连通：不要用localhost作为SONAR_HOST_URL，填写SonarQube服务在局域网内的实际可访问IP+端口（比如SonarQube跑在Windows宿主机上，WSL2环境的runner可通过宿主机内网IP192.168.x.x:9000访问，就填这个地址）。
• 配置完成后先在runner节点上用curl等工具测试对应SonarQube地址可正常访问，再触发流水线即可，Linux环境原生支持该容器类action，不会出现平台兼容报错。

方案2：保留Windows自托管runner，手动执行SonarScanner #

• 跳过官方容器版action，直接在Windows runner机器上下载Windows版本的SonarScanner，配置好系统环境变量，确保在命令行中可直接执行sonar-scanner命令。
• 修改workflow配置，把原来调用sonarsource/sonarqube-scan-action@master的步骤替换为直接执行扫描命令的步骤，参考配置如下：

- name: Execute SonarQube Scan
  env:
    SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
    SONAR_HOST_URL: http://localhost:9000 # runner和SonarQube同属Windows本机时localhost有效
  run: sonar-scanner

方案3：使用GitHub官方托管runner，将SonarQube暴露公网 #

如果不想维护自托管runner，需要把你本地部署的SonarQube服务映射到公网，获得公网可直接访问的IP/域名，将SONAR_HOST_URL配置为该公网地址，同时在SonarQube后台配置对应公网访问权限、放开防火墙限制，保证云端runner可正常连通服务即可。

注意事项 #

• 每次修改配置前，先在runner运行环境内直接访问SONAR_HOST_URL对应地址，确认可打开SonarQube首页后再触发流水线，减少无效调试。
• 使用WSL2作为runner节点时，注意检查Windows防火墙规则，避免拦截WSL对9000端口的访问请求。
• 连通性问题解决后，核对sonar-project.properties内的sonar.projectKey、sonar.sources等配置和SonarQube后台创建的项目参数一致，避免后续出现项目匹配类报错。

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