OpenCSV重复嵌套Bean映射问题：@CsvRecurse失效后的解决方案咨询

你遇到的这个问题其实是OpenCSV处理同类型嵌套Bean时的常见场景——默认的@CsvRecurse没法区分带不同前缀的列名。下面给你几个实用的解决方案，都能完美适配你的需求：

方案一：使用@CsvRecurse的prefix属性（官方推荐） #

OpenCSV的@CsvRecurse注解其实自带prefix参数，专门用来指定当前嵌套Bean对应的列名前缀，刚好能解决你区分author1和author2的需求。

修改后的代码如下：

Book类 #

public class Book {
    @CsvBindByName
    private String title;
    
    // 指定前缀为"author1 "（注意末尾的空格要和列名格式匹配）
    @CsvRecurse(prefix = "author1 ")
    private Author author1;
    
    // 指定前缀为"author2 "
    @CsvRecurse(prefix = "author2 ")
    private Author author2;
    
    // getter、setter方法省略
}

Author类 #

只需要写不带前缀的基础列名即可，OpenCSV会自动拼接前缀匹配对应列：

public class Author {
    @CsvBindByName(column = "given name")
    private String givenName;
    
    @CsvBindByName(column = "surname")
    private String surname;
    
    // getter、setter方法省略
}

这个方案完全符合OpenCSV的设计规范，代码简洁易维护，是首选方案。

方案二：自定义映射策略（适配复杂列名规则） #

如果你的列名规则更灵活（比如需要正则匹配动态前缀），可以自定义MappingStrategy来处理列名和字段的映射逻辑：

public class CustomAuthorMappingStrategy<T> extends ColumnPositionMappingStrategy<T> {
    @Override
    public void captureHeader(CSVReader reader) throws IOException {
        super.captureHeader(reader);
        // 在这里可以自定义列名与字段的绑定逻辑
        // 比如通过正则匹配author[1/2]的前缀，手动关联到对应的Author字段
    }

    @Override
    public String getColumnName(int col) {
        // 也可以在这里改写列名匹配规则，支持正则或其他自定义逻辑
        return super.getColumnName(col);
    }
}

然后在构建CsvToBean时使用这个自定义策略：

try (CSVReader reader = new CSVReader(new FileReader("your-file.csv"))) {
    CsvToBean<Book> csvToBean = new CsvToBeanBuilder<Book>(reader)
            .withType(Book.class)
            .withMappingStrategy(new CustomAuthorMappingStrategy<>())
            .build();
    List<Book> books = csvToBean.parse();
} catch (IOException e) {
    e.printStackTrace();
}

这个方案灵活性拉满，但代码复杂度较高，适合非常规的列名场景。

方案三：手动解析映射（最可控的方式） #

如果以上两种方案都不满足你的需求，还可以手动读取每一行CSV数据，自己实例化并赋值Bean：

try (CSVReader reader = new CSVReader(new FileReader("your-file.csv"))) {
    // 跳过表头
    reader.readNext();
    String[] row;
    while ((row = reader.readNext()) != null) {
        Book book = new Book();
        book.setTitle(row[0]);
        
        // 手动创建并赋值author1
        Author author1 = new Author();
        author1.setGivenName(row[1]);
        author1.setSurname(row[2]);
        book.setAuthor1(author1);
        
        // 手动创建并赋值author2
        Author author2 = new Author();
        author2.setGivenName(row[3]);
        author2.setSurname(row[4]);
        book.setAuthor2(author2);
        
        // 处理当前Book实例
    }
} catch (IOException e) {
    e.printStackTrace();
}

这种方式代码量稍大，但完全可控，适合任何复杂的列结构或特殊需求。

总结 #

优先推荐方案一，因为它是OpenCSV官方支持的标准用法，简洁高效。如果你的列名规则特殊，再考虑方案二或三。

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