使用Travis官方插件推送至自部署SonarQube失败求助

我懂你这种想用官方插件却卡壳的烦躁感——临时用Sonar Scanner虽然能凑活，但总不如官方集成来得顺手。咱们来一步步排查官方插件失效的原因，把这个流程给理顺：

1. 先核对版本兼容性 #

Travis的官方SonarQube插件对自部署服务器的版本有严格要求，很多时候失效都是因为版本不匹配导致API调用失败。

• 先确认你的自部署SonarQube版本（比如7.9、9.9等），再对应找Travis插件的兼容版本
• 在.travis.yml里可以直接指定插件版本，避免自动拉取不兼容的版本：

  addons:
    sonarqube:
      version: "9.9" # 换成和你服务器匹配的版本
      host: https://your-self-hosted-sonarqube.example.com
  

2. 检查服务器访问权限与令牌配置 #

自部署的SonarQube往往有防火墙或私有网络限制，加上权限配置不对，插件根本连不上服务器：

• 确保Travis能访问你的服务器：如果服务器在私有网络，要开放Travis的IP段访问，或者用公网可访问的域名/IP
• 配置正确的SonarQube令牌：在SonarQube后台生成一个拥有「项目分析权限」的令牌，然后在Travis的项目设置里添加加密的SONAR_TOKEN环境变量，或者直接在配置里写加密后的令牌：

  addons:
    sonarqube:
      host: https://your-self-hosted-sonarqube.example.com
      token:
        secure: "your-encrypted-token-here"
  

• 确认项目权限：令牌对应的账号必须有你要分析项目的「执行分析」权限，不然会返回403错误

3. 调整Travis构建流程与Sonar参数 #

官方插件默认在script阶段后运行，但如果你的测试流程是自定义阶段，可能会跳过插件执行，或者缺少必要的Sonar配置：

• 明确构建阶段顺序：把Sonar分析放在测试完成后的阶段，确保测试数据（比如覆盖率报告）已经生成：

  stages:
    - test
    - sonarqube
  
  jobs:
    include:
      - stage: test
        script:
          - npm install
          - npm run test -- --coverage # 生成Sonar需要的覆盖率报告
      - stage: sonarqube
        addons:
          sonarqube:
            host: https://your-self-hosted-sonarqube.example.com
            token:
              secure: "your-encrypted-token"
            properties:
              sonar.projectKey: your-project-key
              sonar.sources: src/
              sonar.tests: tests/
              sonar.javascript.coverageReportPaths: coverage/lcov.info # 对应你的覆盖率报告路径
        script: skip # 官方插件会自动触发分析，这里无需自定义脚本
  

• 补充Sonar项目配置：如果项目根目录没有sonar-project.properties，一定要在Travis配置里通过properties字段指定必要参数（比如项目Key、源码目录、测试目录）

4. 从Travis日志找具体错误 #

如果以上步骤都试过还是不行，去Travis的构建日志里搜「Sonar」相关的输出，错误信息会直接告诉你问题所在：

• 401 Unauthorized：令牌无效或者没有正确注入到环境变量
• 403 Forbidden：令牌没有项目分析权限
• 404 Not Found：SonarQube服务器地址写错，或者项目Key不存在
• 超时错误：服务器不可访问，检查网络和防火墙设置

等你把这些点都排查一遍，官方插件应该就能正常工作了——比起手动拉取Sonar Scanner，官方插件会自动处理依赖安装、环境变量注入，流程更简洁也更稳定。

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