目录核心报错拆解字面含义四大常见诱因按概率排序1. SonarQube 服务端与本地 Scanner 版本严重不匹配最高频2. SonarQube 服务端接口返回异常数据返回空 / 残缺 JSON3. Jenkins 配置参数错误覆盖了服务端接口返回数据4. 缓存 / 权限问题干扰文件列表解析分步解决方案步骤 1统一 Scanner 与 SonarQube 服务端版本优先修复步骤 2校验 sonar.host.url 连通性步骤 3清理损坏缓存步骤 4排查代理与认证步骤 5临时规避方案离线扫描最简总结核心报错拆解java.lang.IllegalStateException: Fail to download libraries from server Caused by: java.lang.ArrayIndexOutOfBoundsException: Index 1 out of bounds for length 1 at org.sonar.runner.Bootstrapper.getBootstrapFiles(Bootstrapper.java:224)字面含义Bootstrapper 从 SonarQube 服务端拉取启动依赖文件列表时拿到的数组长度只有1代码却尝试读取下标1数组下标从 0 开始长度 1 仅能访问下标 0数组越界。四大常见诱因按概率排序1. SonarQube 服务端与本地 Scanner 版本严重不匹配最高频旧版 Sonar Runner老 sonar-runner 独立工具连接新版 SonarQube 服务端9.x/10.x新版 SonarQube 接口返回的启动文件格式重构老解析代码不兼容返回数组长度变短直接下标越界。反向新版 Scanner 连接极其老旧 SonarQube 5.x/6.x 服务端接口返回数据格式不兼容。2. SonarQube 服务端接口返回异常数据返回空 / 残缺 JSON触发场景Jenkins 机器无法完整访问 SonarQube/batch/index引导接口网络拦截、反向代理 Nginx/Apache 截断响应、防火墙丢包SonarQube 服务宕机 / 内存溢出接口返回半截 JSON、空数组HTTPS 证书、代理配置错误接口返回 401/403/500 错误页面而非标准 JSON Bootstrapper 解析残缺响应生成数组长度 1代码硬编码读取下标 1 直接报错。3. Jenkins 配置参数错误覆盖了服务端接口返回数据错误配置示例sonar.host.url填错填成前端页面地址、带多余路径、IP 端口错误配置了无效sonar.bootstrap.url自定义引导地址返回非法数据代理参数sonar.http.proxy配置错乱网络转发篡改接口返回内容4. 缓存 / 权限问题干扰文件列表解析日志可见缓存目录/var/jenkins_home/.sonar/cache旧缓存文件损坏Scanner 读取本地缓存文件列表格式错乱Jenkins 用户无权限读写缓存目录读取缓存时获取残缺数据分步解决方案步骤 1统一 Scanner 与 SonarQube 服务端版本优先修复查看 SonarQube 服务端版本页面底部替换对应兼容扫描器SonarQube 7.9使用sonar-scanner推荐废弃老旧sonar-runnerSonarQube 10.x必须使用 5.0 版本 sonar-scannerJenkins 全局工具配置中更新 Sonar Scanner 版本。步骤 2校验 sonar.host.url 连通性在 Jenkins 机器手动执行 curl 测试引导接口# 替换为你的Sonar地址 curl http://sonar-server:9000/batch/index正常返回一段 JSON 数组包含启动 jar 包信息异常返回 HTML 报错、空内容、401/500 → 修复网络 / 代理 / 权限 / Nginx 反向代理配置。步骤 3清理损坏缓存Jenkins Pipeline 构建前增加清理命令rm -rf /var/jenkins_home/.sonar/cache rm -rf ./target/.sonar或修改 Jenkins 启动用户赋予.sonar目录完整读写权限。步骤 4排查代理与认证若 SonarQube 需账号密码登录确认配置plaintextsonar.login管理员token sonar.password若内网需要代理正确配置代理参数不要错误代理内网 Sonar 地址plaintextsonar.http.proxyHostxxx sonar.http.proxyPortxxx sonar.http.nonProxyHostssonar-server步骤 5临时规避方案离线扫描网络 / 接口长期不通时使用离线模式提前把 Sonar 依赖包下载到 Jenkins 机器本地跳过从服务端下载引导库逻辑。最简总结报错本质Scanner 解析 SonarQube 服务端返回的启动文件列表时数据格式异常90% 情况是扫描器与服务端版本不兼容其次是网络 / 代理导致接口返回残缺数据。