GitLab CI中SonarQube质量门检查超时问题排查求助

GitLab CI流水线中持续收到SonarQube扫描超时报错：

Failed to execute goal org.sonarsource.scanner.maven:sonar-maven-plugin:3.9.1.2184:sonar (default-cli) on project com.my-app: Quality Gate check timeout exceeded

对应的gitlab-ci.yml配置：

sonar:
  stage: report
  needs:
    - build
  image: maven:3.8.6-amazoncorretto-17
  tags:
    - my-runner
  allow_failure: true
  variables:
    SONAR_USER_HOME: "${CI_PROJECT_DIR}/.sonar"
    SONAR_TOKEN: "my-token"
    SONAR_HOST_URL: "https://sonar-server/"
    GIT_DEPTH: 0
  cache:
    <<: *maven_cache
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      when: always   
  script:
    - mvn clean package
    - mvn -gs ../pom.xml sonar:sonar -Dsonar.qualitygate.wait=true -Dsonar.java.binaries=./target/classes

• SonarQube服务器资源不足：若服务器CPU、内存负载过高，代码扫描和质量门评估的处理速度会大幅下降，导致客户端等待超时。可查看服务器监控数据确认是否存在资源瓶颈。
• 默认超时时间过短：Sonar Maven插件默认质量门等待超时为300秒（5分钟），如果项目代码量大、检测规则多，扫描+评估耗时超过这个阈值就会触发报错。可添加-Dsonar.qualitygate.timeout=XXX参数（XXX为自定义秒数，比如600）延长超时时间。
• 重复构建浪费时间：脚本中先执行mvn clean package，之后又运行Sonar扫描，而Sonar扫描本身可按需触发编译，重复构建会额外消耗时间，间接增加超时风险。可考虑移除单独的mvn clean package步骤，或确保构建产物被缓存复用。
• GitLab Runner资源受限：执行扫描的Runner如果CPU、内存配置不足，会拖慢Maven和Sonar扫描的执行速度，导致整体流程耗时过长。可检查Runner的资源配置，更换资源更充足的Runner节点。
• 网络延迟过高：SonarQube服务器与GitLab Runner之间的网络连接不稳定、延迟大，会拉长客户端等待服务器返回质量门结果的时间，容易触发超时。可测试两者间的网络连通性和延迟情况。
• 插件版本老旧：当前使用的Sonar Maven插件版本（3.9.1.2184）较旧，可能存在性能问题或已知的超时bug。可尝试升级到最新稳定版插件。

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