拆分GitHub Actions作业后SonarQube令牌授权失败原因咨询

核心原因 #

1. SonarQube实例的环境隔离问题 #

你在complete-build-test-analysis作业中启动的SonarQube容器，仅运行在该作业专属的执行环境内——哪怕是self-hosted runner，每个GitHub Actions作业默认都是独立的执行单元，localhost指向各自的环境。拆分后的article-analysis等作业无法通过localhost:9000访问到之前启动的SonarQube实例，这会导致看似“授权失败”的错误（实际是连接不上SonarQube服务）。而单作业模式下所有步骤共享同一个环境，所以能正常访问。

2. 令牌传递不完整（仅针对article-analysis作业） #

article-analysis中的Maven命令仅设置了SONAR_TOKEN环境变量，但Maven Sonar插件不会自动读取这个变量作为登录令牌，必须显式通过-Dsonar.login参数传递。单作业模式下所有分析步骤都补全了这个参数，因此没有问题。

解决方案 #

方案1：使用固定部署的SonarQube服务（推荐） #

放弃在CI作业中临时启动SonarQube，改用部署在服务器上的固定SonarQube实例，配置统一的可访问sonar.host.url（比如内网IP或域名），让所有作业都能直接访问，彻底避开环境隔离问题。

方案2：调整作业架构共享SonarQube实例 #

如果必须在CI中临时启动SonarQube，需确保所有分析作业与启动SonarQube的作业运行在同一个runner实例：

• 给self-hosted runner设置专属标签，在所有相关作业中通过runs-on: [self-hosted, your-shared-label]指定同一个runner
• 启动SonarQube时，将容器端口映射到宿主机固定端口，sonar.host.url改用宿主机IP而非localhost

方案3：补全令牌传递参数 #

针对article-analysis作业，在Maven命令中添加令牌参数，与farmer、transport作业保持一致：

- name: Compile, Test, and Analyze Article Module
  env:
    SONAR_TOKEN: ${{ secrets.SONAR_TOKEN_STAGING }}
  run: |
    mvn -f ./article/pom.xml clean compile test sonar:sonar \
      -Dsonar.projectKey=Flowcontrol_Article_Module \
      -Dsonar.projectName="Flowcontrol - Article Module" \
      -Dsonar.host.url=${{ secrets.SONAR_HOST_URL }} \
      -Dsonar.login=${{ secrets.SONAR_TOKEN_STAGING }}

注意：此修复仅解决令牌传递问题，核心的SonarQube实例可达性问题仍需通过前两个方案解决，否则即使令牌正确，也会因无法连接服务报错。

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