GitHub Actions中SonarQube令牌生成与扫描索引解析问题求助

一、令牌生成无报错但未创建的问题 #

问题根源 #

你在generate_token步骤里仅在当前shell导出了SONAR_TOKEN，但未将其输出为GitHub Actions的步骤变量，导致后续扫描步骤根本拿不到这个值；另外，curl请求看似成功，实际可能SonarQube返回了错误（比如默认admin密码已被修改、令牌名称重复），只是你没打印响应排查。

修复方案 #

1. 修改令牌生成步骤，添加输出变量并打印响应内容：

- name: Generate SonarQube token
  id: generate_token
  run: |
    # 生成认证用的base64串
    AUTH=$(echo -n "admin:admin" | base64)
    # 发送请求并保存响应，加-v参数查看详细请求日志
    TOKEN_RESPONSE=$(curl -v -X POST -H "Authorization: Basic $AUTH" "http://localhost:9000/api/user_tokens/generate" -d "name=ci-token")
    # 打印响应，排查是否有错误信息
    echo "SonarQube token response: $TOKEN_RESPONSE"
    # 提取令牌并写入GitHub Actions输出变量
    SONAR_TOKEN=$(echo $TOKEN_RESPONSE | jq -r .token)
    echo "SONAR_TOKEN=$SONAR_TOKEN" >> $GITHUB_OUTPUT

2. 排查要点：如果响应里包含errors字段，说明SonarQube拒绝了请求——比如首次启动SonarQube会强制修改admin密码，此时默认的admin:admin无效，需先修改密码再生成令牌。

二、Fail to parse entry in bootstrap index错误 #

问题根源 #

1. 命令语法错误：扫描命令中-Dsonar.login那一行末尾未加反斜杠，导致后续参数被当成新命令，实际执行时sonar.login的值为空（日志显示-Dsonar.login= <TOKEN>，存在多余空格）。
2. 版本不兼容：你使用的SonarScanner 4.6.2是2021年的老版本，与最新SonarQube LTS版本不匹配，会导致bootstrap索引解析失败。
3. 服务未完全就绪：虽然检查了/about接口，但SonarQube的/batch/index接口可能尚未完成初始化，返回空内容引发解析错误。

修复方案 #

1. 修复扫描命令的语法问题：
   确保每一行参数末尾都加反斜杠，去掉sonar.login后的多余空格：

- name: Run SonarQube scan
  run: |
    ./sonar-scanner/bin/sonar-scanner -X \
      -Dsonar.projectKey=gestion-du-materiel \
      -Dsonar.sources=gestion-du-materiel-back/src \
      -Dsonar.host.url=http://localhost:9000 \
      -Dsonar.login=${{ steps.generate_token.outputs.SONAR_TOKEN }} \
      -Dsonar.ws.timeout=60 \
      -Dsonar.ce.task.timeout=600

2. 升级SonarScanner到兼容版本：
   替换为适配SonarQube LTS的最新稳定版（比如5.0.1.3006）：

- name: Set up SonarQube Scanner
  run: |
    curl -O https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-5.0.1.3006-linux.zip
    unzip sonar-scanner-cli-5.0.1.3006-linux.zip
    mv sonar-scanner-5.0.1.3006-linux sonar-scanner
    # 正确设置PATH
    echo "$(pwd)/sonar-scanner/bin" >> $GITHUB_PATH

3. 优化SonarQube就绪检查逻辑：
   直接检查/batch/index接口是否返回有效内容，而非仅检查/about：

- name: Wait for SonarQube to be ready
  run: |
    echo "Waiting for SonarQube to be ready..."
    while true; do
      # 检查batch/index接口返回非空内容
      RESPONSE=$(curl -s http://localhost:9000/batch/index)
      if [ -n "$RESPONSE" ]; then
        echo "SonarQube is ready."
        break
      fi
      echo "SonarQube is not ready yet... retrying in 30 seconds."
      sleep 30
    done

4. 调整SonarQube容器启动参数：
   首次启动SonarQube需初始化数据库，耗时可能较长；同时GitHub Actions默认runner内存有限，可指定内存参数：

- name: Start SonarQube container
  run: |
    docker run -d --name sonarqube -p 9000:9000 \
      -e SONAR_JAVA_OPTS="-Xmx2G -Xms1G" \
      sonarqube:lts

额外提示 #

• 不要在CI流程中使用默认admin账户生成令牌，建议提前在SonarQube创建专门的CI用户，将令牌存储在GitHub Secrets中，直接调用更安全高效。
• 可通过docker logs sonarqube查看容器日志，排查启动时的错误（比如内存不足、数据库初始化失败）。

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