OpenCSV升级5.x后parse方法报Error capturing CSV header异常

这是OpenCSV大版本升级带来的默认行为差异导致的：

• OpenCSV 4.x版本的CSV解析器默认会自动忽略每个字段（包含表头）的前后空白字符，因此带前导空格的表头可以和@CsvBindByName配置的列名正常匹配
• OpenCSV 5.x及之后版本调整了默认配置，解析字段时默认保留前后空白，做严格精确匹配。你的CSV首个表头 incentive-program-id带前导空格，和注解配置的incentive-program-id无法对应，因此抛出必填字段缺失的异常。

方案1：解析层配置自动忽略字段前后空白（推荐，对齐4.x版本行为） #

替换原有直接new CSVReader的初始化逻辑，使用Builder模式构造解析器，开启前后空白忽略配置，改动最小、适配性最强：

public static List<CSVCouponData> parseCSVFile(InputStream inputStream) throws IOException {
        CSVReader reader = null;
        List<CSVCouponData> rec = null;
        try {
           // 替换原有reader初始化逻辑 start
           CSVParser csvParser = new CSVParserBuilder()
                   .withIgnoreLeadingWhitespaces(true)
                   .withIgnoreTrailingWhitespaces(true)
                   .build();
           reader = new CSVReaderBuilder(new InputStreamReader(inputStream))
                   .withCSVParser(csvParser)
                   .build();
           // 替换原有reader初始化逻辑 end

           HeaderColumnNameMappingStrategy<CSVCouponData> beanStrategy = new HeaderColumnNameMappingStrategy<>();
           beanStrategy.setType(CSVCouponData.class);

           CsvToBean<CSVCouponData> csvToBean = new CsvToBean<>();
           csvToBean.setCsvReader(reader);
           csvToBean.setMappingStrategy(beanStrategy);
           csvToBean.setIgnoreEmptyLines(true);
           rec = csvToBean.parse();
       } finally {
            if(reader != null)
                reader.close();
       }

        return rec;
    }

该配置在解析阶段生效，会自动去除所有字段（表头+数据行）的前后空白字符，和你之前使用4.x版本的行为完全一致，不需要修改实体类、不需要调整CSV文件。

方案2：自定义表头匹配转换逻辑 #

如果不希望全局去除所有数据字段的前后空白，仅需要处理表头匹配问题，可以给映射策略配置列名转换器，仅对读取到的表头做trim处理后再匹配：

HeaderColumnNameMappingStrategy<CSVCouponData> beanStrategy = new HeaderColumnNameMappingStrategy<>();
beanStrategy.setType(CSVCouponData.class);
// 配置表头转换规则：统一去除前后空白后再做匹配，可根据需要追加转小写等规则
beanStrategy.setColumnNameMapper(String::trim);

该方案仅影响表头和注解列名的匹配逻辑，不会修改数据行读取到的原始值。

不要通过在@CsvBindByName的column属性前硬编码空格的方式适配，这种方式对空格数量、位置极度敏感，一旦上传的CSV格式有微小变动就会再次触发异常。

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