如何在 OpenCSV 中自动修剪 CSV 表头和字段的首尾空格-java教程-PHP中文网

如何在 OpenCSV 中自动修剪 CSV 表头和字段的首尾空格

本文介绍使用 OpenCSV 4.6 时，通过自定义 CSVReader 子类实现表头与数据行自动去空格，解决 @CsvBindByName 因 " First name " 等带空格表头导致 CsvRequiredFieldEmptyException 的问题。

本文介绍使用 opencsv 4.6 时，通过自定义 `csvreader` 子类实现表头与数据行自动去空格，解决 `@csvbindbyname` 因 `" first name "` 等带空格表头导致 `csvrequiredfieldemptyexception` 的问题。

OpenCSV 默认对 CSV 表头（header）和字段值的匹配是严格区分空格的——这意味着 "First name" 和 " First name " 被视为两个完全不同的列名，从而导致 @CsvBindByName(column = "First name") 绑定失败，并抛出类似 Header is missing required fields [FIRST NAME] 的异常。

根本原因在于：CsvToBeanBuilder 在解析时会先读取首行作为 header 数组，而原始 CSVReader 并不会对 header 字符串做任何预处理（如 trim()）。因此，即使业务逻辑允许“宽松匹配”，也需从读取层介入。

✅ 推荐方案：继承 CSVReader 并重写关键读取方法，统一修剪 header 和每行数据的每个字段：

csv to excel

将CSV文件转换为支持中文字符、自动格式化、多工作表的专业Excel工作簿。

下载

import com.opencsv.CSVReader;
import com.opencsv.exceptions.CsvValidationException;

import java.io.IOException;
import java.io.Reader;
import java.util.Arrays;
import java.util.Objects;

public class TrimmingCsvReader extends CSVReader {
    public TrimmingCsvReader(Reader reader) {
        super(reader);
    }

    @Override
    public String[] peek() throws IOException {
        return trim(super.peek());
    }

    @Override
    public String[] readNext() throws IOException, CsvValidationException {
        return trim(super.readNext());
    }

    @Override
    public String[] readNextSilently() throws IOException {
        return trim(super.readNextSilently());
    }

    private static String[] trim(String[] line) {
        if (line != null) {
            Arrays.setAll(line, i -> Objects.toString(line[i], "").trim());
        }
        return line;
    }
}

⚠️ 注意事项：

此方案同时作用于 表头行（peek() 返回的首行）和 所有数据行，确保字段值也自动去空格，符合常见清洗需求；

CsvToBeanBuilder 构造时需传入该自定义 reader，而非默认构造器：

Reader reader = new StringReader(" First name ,age\n John ,25");
try (TrimmingCsvReader csvReader = new TrimmingCsvReader(reader)) {
    CsvToBean<linedto> csvToBean = new CsvToBeanBuilder<linedto>(csvReader)
            .withType(LineDto.class)
            .withIgnoreLeadingWhiteSpace(true) // 可选：增强兼容性
            .withSkipLines(0)
            .build();
    List<linedto> beans = csvToBean.parse();
}</linedto></linedto></linedto>

withIgnoreLeadingWhiteSpace(true) 是 OpenCSV 内置选项，仅影响字段内部分隔符前后的空白（如 a, b 中的 b 前空格），不处理 header 字符串本身，因此不能替代 trim() 逻辑；
若项目中已广泛使用 @CsvBindByPosition 或需差异化处理（如仅 trim header 不 trim 数据），可进一步拆分逻辑，例如仅重写 peek() 并在 CsvToBean 初始化前手动处理 header。