Spring Boot导入CSV时触发ArrayIndexOutOfBoundsException的原因排查

异常原因 #

1. 行数据字段数量不足：代码尝试访问line[3]（对应第4个字段），但实际某行CSV分割后数组长度仅为3，说明该行缺少字段——比如部分数据行漏填了company_email列，或CSV格式错误导致字段被合并。
2. 分隔符不匹配：如果CSV实际用制表符、分号等分隔符，但CSVParser用逗号split(",")分割，会导致整行被当成一个元素，数组长度为1，访问line[3]必然越界。
3. 未跳过表头行：若CSV第一行是表头（如firstName,lastName,...），但代码直接解析表头行，可能因表头字段数不符或被误当成数据行触发异常。
4. 存在空行/无效行：CSV里的空行（或全空白行）分割后得到长度为0的数组，访问line[3]自然报错。
5. 手动split的局限性：用String.split()处理CSV时，无法正确处理字段包含分隔符的情况（如字段值是"Smith, John"），会导致分割后字段数混乱。

解决方法 #

• 先校验字段数量再访问：读取line[index]前先判断数组长度是否达标，避免越界：

  if (line.length >= 4) {
      String companyEmail = line[3];
      // 后续业务逻辑
  } else {
      // 记录日志并跳过无效行
      log.error("CSV行字段数不足，当前行内容：{}", Arrays.toString(line));
      continue;
  }
  

• 统一分隔符配置：确认CSV文件的实际分隔符，和代码分割逻辑保持一致；若不确定，建议让用户明确分隔符，或用专业库自动识别。
• 跳过表头行：解析时先读取并跳过第一行表头，再处理数据行：

  BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
  // 跳过表头
  reader.readLine();
  String line;
  while ((line = reader.readLine()) != null) {
      // 处理数据行逻辑
  }
  

• 过滤空行与无效行：处理每行前先判断是否为空或全空白：

  while ((line = reader.readLine()) != null) {
      line = line.trim();
      if (line.isEmpty()) {
          continue;
      }
      // 分割并处理数据
  }
  

• 改用专业CSV解析库：放弃手动split，使用OpenCSV、Apache Commons CSV等成熟库，它们能处理带引号字段、换行字段等复杂CSV格式。示例用OpenCSV：

  // Maven依赖
  <!-- pom.xml -->
  <dependency>
      <groupId>com.opencsv</groupId>
      <artifactId>opencsv</artifactId>
      <version>5.6</version>
  </dependency>
  
  // 解析代码
  try (CSVReader csvReader = new CSVReader(new InputStreamReader(file.getInputStream()))) {
      // 跳过表头
      csvReader.readNext();
      String[] row;
      while ((row = csvReader.readNext()) != null) {
          if (row.length >= 5) { // 确保5个必填字段存在
              Guest guest = new Guest();
              guest.setFirstName(row[0]);
              guest.setLastName(row[1]);
              guest.setPhoneNumber(row[2]);
              guest.setCompanyEmail(row[3]);
              guest.setPosition(row[4]);
              // 保存嘉宾数据
              guestRepository.save(guest);
          }
      }
  } catch (IOException e) {
      log.error("CSV解析失败", e);
      throw new RuntimeException("导入失败");
  }
  

• 调试输出定位问题行：在报错位置前打印当前行的分割结果，快速定位异常行：

  String[] line = ...; // 你的分割逻辑
  System.out.println("当前行分割结果：" + Arrays.toString(line));
  if (line.length >=4) {
      // 访问line[3]
  }
  

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