AWS CodeBuild容器中SonarScanner CLI突发java.lang.ArrayIndexOutOfBoundsException错误求助

从你提供的错误栈来看，问题出在Sonar的YAML分析插件处理某个YAML文件时触发了数组越界异常——具体是snakeyaml库在读取YAML文件时遇到了无法解析的内容，导致扫描直接崩溃，连结果都没传到Sonar服务器。下面是一步步的排查方案：

1. 先定位触发问题的具体文件 #

首先按照错误提示，添加-X参数启用调试日志，重新运行SonarScanner命令：

sonar-scanner -X -Dsonar.projectKey=$sonar_project_key -Dsonar.sources=$CODEBUILD_SRC_DIR -Dsonar.host.url=$sonar_host_url -Dsonar.login=$sonar_login

调试日志会详细输出扫描过程中处理的每个文件，找到崩溃前最后一条“Processing file”相关的日志，对应的YAML文件就是问题根源。

2. 检查问题YAML文件的语法与编码 #

这个ArrayIndexOutOfBoundsException通常是YAML文件本身有问题，常见原因包括：

• 损坏的特殊字符：比如不可见的控制字符、非UTF-8编码的字符（比如GBK编码的中文却被当作UTF-8解析）
• 不完整的YAML结构：比如未闭合的引号、错误的缩进、中断的序列/映射
• 文件编码问题：带有BOM标记的UTF-8文件，或者非标准编码

你可以：

• 在本地用yamllint工具直接检查该文件：yamllint path/to/problematic-file.yaml，工具会直接指出语法错误
• 用文本编辑器打开文件，开启“显示不可见字符”功能，检查是否有奇怪的换行、空格或控制字符
• 确保文件是纯UTF-8编码，没有BOM

3. 排查环境变化（为什么之前正常现在失效） #

既然之前运行正常，突然报错，大概率是环境或代码有变更：

• Sonar相关组件版本变化：CodeBuild容器里的SonarScanner版本、Sonar服务器上的YAML插件版本是否有更新？新版本可能引入了对YAML语法更严格的检查，或者兼容性问题
• 代码变更：近期是否新增/修改了YAML文件？有没有引入上述的语法/编码问题
• CodeBuild基础镜像变更：是否切换了CodeBuild的运行镜像？新镜像的Java版本、依赖库版本可能和之前不同，导致snakeyaml解析行为变化

4. 临时应急方案 #

如果需要先让扫描恢复运行，可以在SonarScanner命令中添加排除参数，跳过问题文件：

sonar-scanner -Dsonar.projectKey=$sonar_project_key -Dsonar.sources=$CODEBUILD_SRC_DIR -Dsonar.host.url=$sonar_host_url -Dsonar.login=$sonar_login -Dsonar.exclusions=**/problematic-file.yaml

这样扫描会绕过该文件，先完成其他代码的分析，之后再回头修复那个YAML文件的问题。

如果按照上面的步骤还是没找到问题，可以把调试日志中处理到崩溃前的文件列表、问题YAML文件的内容（敏感信息脱敏后）贴出来，方便进一步排查。

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