如何解决OpenCSV的CsvToBean零宽不换行空格表头匹配问题？

OpenCSV的@CsvBindByName注解是基于精确字符串匹配来绑定CSV列和POJO字段的。你遇到的零宽不换行空格（U+FEFF）是不可见的Unicode控制字符，它会被当作表头字符串的一部分存在，导致表头实际内容是\uFEFFpoint，和你注解中指定的"point"完全不匹配，因此OpenCSV无法找到对应的列，最终解析后该字段值为null。

方法一：自定义表头映射策略，移除控制字符（推荐通用方案） #

通过自定义HeaderColumnNameMappingStrategy，在捕获表头时自动移除所有不可见的控制字符（包括U+FEFF），确保表头和注解中的字段名一致：

class CustomHeaderMappingStrategy<T> extends HeaderColumnNameMappingStrategy<T> {
    @Override
    public void captureHeader(CSVReader reader) throws IOException {
        super.captureHeader(reader);
        String[] headers = getHeader();
        if (headers != null) {
            for (int i = 0; i < headers.length; i++) {
                // 移除所有非换行、回车、制表符的控制字符
                headers[i] = headers[i].replaceAll("[\\p{Cntrl}&&[^\\r\\n\\t]]", "");
            }
            setHeader(headers);
        }
    }
}

在构建CsvToBean时指定这个自定义策略：

CsvToBean<Pojo> bean = new CsvToBeanBuilder<Pojo>(reader)
        .withMappingStrategy(new CustomHeaderMappingStrategy<>())
        .build();

方法二：跳过文件开头的BOM字符（针对UTF-8 BOM场景） #

如果U+FEFF是出现在文件开头的UTF-8 BOM（很多编辑器保存UTF-8文件时会自动添加），可以直接在创建CSVReader时开启BOM跳过功能：

CSVReader reader = new CSVReaderBuilder(new FileReader("your.csv"))
        .withSkipBom(true)
        .build();

注意：该方法仅处理文件开头的BOM，若表头中间夹杂U+FEFF，需要搭配方法一使用。

方法三：硬编码匹配带BOM的表头（不推荐） #

直接在@CsvBindByName的column属性中写入带U+FEFF的字符串：

@CsvBindByName(column="\uFEFFpoint")
Integer point;

这种方式仅适用于表头固定带该字符的场景，灵活性差，不建议用于通用解析逻辑。

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