Drone CI中SonarQube分析随机报分析缓存下载失败故障

故障基本情况 #

故障出现在Drone CI构建流程的SonarQube代码分析环节，使用的流水线配置片段如下：

- name: code-analysis
  image: aosapps/drone-sonar-plugin
  settings:
     sonar_host:
       from_secret: sonar_host
     sonar_token:
       from_secret: sonar_token

故障无固定复现规律：重启同一构建任务有时可正常通过，有时仍然失败，发作完全随机。核心报错堆栈最终落点为java.lang.IllegalStateException: Failed to download analysis cache，外层嵌套多层Spring Bean依赖注入失败的错误信息。

同类问题反馈情况 #

该问题不是个例，自SonarQube 9.x版本上线增量分析缓存特性后，在Drone、GitLab CI、GitHub Actions等各类CI环境中都有开发者反馈过同类随机故障。

故障根本原因 #

• 核心设计缺陷：SonarQube 9.0+版本默认开启分析缓存机制，扫描启动阶段会主动从服务端拉取上一次构建的分析缓存，用于提速增量扫描流程，早期版本的SonarScanner客户端对这个拉取动作没有做容错降级处理，只要拉取失败就直接终止整个扫描任务，不会自动切换到全量扫描模式。
• 随机发作的直接诱因：
  • CI运行节点和SonarQube服务端之间出现瞬时网络抖动、丢包，缓存文件传输中途连接断开
  • SonarQube服务端负载过高时，缓存接口响应超时，没有返回有效缓存文件
  • 低版本aosapps/drone-sonar-plugin内置的SonarScanner存在边缘场景bug，遇到服务端缓存不存在、返回跳转响应时，直接抛出异常终止流程

可落地的修复方案 #

按生效速度和改造成本从低到高排序：

• 临时快速修复：关闭分析缓存
  在插件配置中增加sonar_cache_enable: "false"参数，直接跳过缓存拉取逻辑，全程走全量扫描，修改后配置如下：

  - name: code-analysis
    image: aosapps/drone-sonar-plugin
    settings:
       sonar_host:
         from_secret: sonar_host
       sonar_token:
         from_secret: sonar_token
       sonar_cache_enable: "false"
  

  该方案会让单次扫描耗时增加10%-30%，具体涨幅和项目代码规模相关，不会影响扫描结果的准确性，适合快速恢复流水线可用性。
• 平衡性能与稳定性：调整缓存配置+升级插件
  保留缓存提速能力的同时降低故障概率：
  • 将aosapps/drone-sonar-plugin升级到最新可用版本，新版内置的高版本SonarScanner已经增加了缓存拉取失败的降级逻辑，拉取失败时会自动切全量扫描，不会直接任务失败
  • 增加配置项sonar_scanner_http_timeout: 60000，将默认10秒的HTTP请求超时调整为60秒，避免大体积缓存文件拉取超时
• 长期根治：排查链路与服务端稳定性
  • 检查Drone CI节点到SonarQube服务端的网络链路，排查跨网段、防火墙、负载均衡层的丢包、连接超时配置问题
  • 监控SonarQube服务端的CPU、内存、接口响应耗时指标，构建高峰时段如果服务负载过高及时扩容，避免接口响应异常

内容的提问来源于stack exchange，提问作者Raphaël GICQUIAUX