You need to enable JavaScript to run this app. Docker中SonarScanner配合SonarQube 7.9.5 LTS 加载活跃规则后挂起
优惠活动
大模型
产品
解决方案
定价
更多

Docker中SonarScanner配合SonarQube 7.9.5 LTS 加载活跃规则后挂起

7.9.5版本SonarQube扫描挂起排查指引

已知问题特征

  • 扫描日志固定停在「Load active rules (done)」节点,无后续流程输出
  • 扫描器容器内Java进程CPU利用率接近0%,处于空闲阻塞状态,无高负载、进程崩溃特征
  • 完全相同的扫描流程对接8.4.2版本SonarQube可正常运行
  • 当前组件版本组合:SonarQube 7.9.5 LTS,内置Sonar Scanner CLI 4.5.0.2216

分步骤排查操作

1. 优先校验版本兼容性匹配

版本错位是当前场景下最高发的挂起原因

  • SonarQube 7.9.x官方声明兼容的最高Scanner CLI版本为4.4.0.2170,你当前使用的4.5.0.2216版本是为SonarQube 8.x大版本设计的客户端,在完成活跃规则拉取后的项目元数据交互环节,会存在protobuf序列化协议不兼容的问题,表现为无限等待服务端返回、无任何错误日志抛出
  • 快速验证方式:临时将扫描器版本替换为4.4.0.2170后重新触发扫描,观察是否可跳过挂起节点

2. 排查网络层半连接阻塞

从top输出的CPU 99% idle、Load average接近5的特征可以判断,进程无本地计算逻辑在运行,阻塞点为网络IO等待:

  • 扫描挂起时,进入扫描器容器执行netstat -anp | grep java,查看和SonarQube服务端的TCP连接状态
  • 重点排查两类场景:
    • 连接处于ESTABLISHED但无双向数据包传输,多为Docker link网络转发规则导致大体积响应包被截断、或TCP keepalive未开启导致的静默断连
    • 连接处于CLOSE_WAIT状态,说明服务端已主动关闭连接但扫描器客户端未感知到,持续等待数据
  • 可在扫描器容器内手动复现日志中的规则拉取请求,确认响应是否可被完整接收、正常关闭

3. 抓取线程快照精确定位阻塞点

扫描挂起时无需重启容器,直接抓取Java线程快照定位根因:

  • 执行命令jstack 1 > /tmp/scanner_thread_dump.log(对应top输出中Java进程PID为1)
  • 查看主线程栈的阻塞状态:
    • 如果线程阻塞在socketRead调用栈,说明等待服务端响应,需排查服务端侧在活跃规则加载完成后触发的接口(项目配置拉取、权限校验、插件扩展回调)是否存在响应超时
    • 如果线程阻塞在内部锁等待状态,说明为扫描器类加载死锁,基本可确认是版本不匹配导致

4. 验证7.9.5版本已知缺陷影响

7.9.5版本存在公开缺陷:当单个质量配置文件绑定的规则总数超过接口分页阈值(ps=500)时,第二页及后续的规则拉取接口会在响应完成后不主动关闭连接,导致扫描器客户端无限等待连接关闭事件。表现为日志打印规则加载完成,但实际流程卡在连接等待逻辑中

  • 快速验证方式:将目标质量配置文件下绑定的规则总数临时调整到500条以内,重新触发扫描测试

内容的提问来源于stack exchange,提问作者scsarver

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 09:24:03