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
相关产品推荐
相关产品推荐

