使用Jackson读取CSV并生成Map时遇问题，求助解决方案

嘿，我看你在用Jackson的CsvMapper读取CSV文件并转换成List<R>（其中R继承自泛型类IndexedData<T>）的时候遇到了问题，先把你没写完的代码补全，再给你梳理几个高频踩坑点和对应的解决方案：

首先，先补全你给出的不完整代码，通常完整的读取逻辑应该是这样的：

private static <T, R extends IndexedData<T>> List<R> readFile(File csvFile, Class<R> cls) throws Exception {
    CsvMapper csvMapper = new CsvMapper();
    CsvSchema csvSchema = csvMapper.typedSchemaFor(cls)
            .withHeader()
            .withStrictHeaders(true);
    List<R> list = csvMapper.readerFor(cls)
            .with(csvSchema)
            .readValues(csvFile)
            .readAll();
    return list;
}

接下来是几个常见问题的解决思路：

1. CSV表头和实体类字段不匹配导致映射失败 #

如果你的IndexedData<T>或者子类R的字段名和CSV表头不一致，再加上开启了withStrictHeaders(true)，Jackson会直接抛出异常；就算没开严格匹配，也会出现字段值为null的情况。

解决办法：

• 用@JsonProperty注解手动指定CSV表头和实体类字段的对应关系，比如：

public abstract class IndexedData<T> {
    @JsonProperty("INDEX_ID") // 对应CSV里的"INDEX_ID"表头
    private int index;
    @JsonProperty("DATA_CONTENT") // 对应CSV里的"DATA_CONTENT"表头
    private T data;
    
    // 别忘了加getter和setter
}

2. 开启严格表头匹配后，多列/少列报错 #

当你设置withStrictHeaders(true)时，CSV的表头必须和实体类通过Jackson映射的字段完全一一对应，多一列或者少一列都会触发异常。

解决办法：

• 如果CSV里有无关的额外列，可以把withStrictHeaders(true)改成withStrictHeaders(false)，Jackson会自动忽略不匹配的列；
• 如果你需要保留严格校验，但CSV确实有额外列，可以在实体类里添加对应的字段，并用@JsonIgnore注解标记，让Jackson忽略这些字段的映射。

3. 泛型类型T无法正确反序列化 #

因为IndexedData<T>是泛型类，Jackson在运行时可能无法识别T的具体类型，导致把T解析成默认的LinkedHashMap，而不是你期望的类型（比如String、Integer）。

解决办法：

• 修改方法，让调用者传入T的具体类型，用JavaType来指定泛型参数：

private static <T, R extends IndexedData<T>> List<R> readFile(File csvFile, Class<R> cls, Class<T> dataType) throws IOException {
    CsvMapper csvMapper = new CsvMapper();
    // 构建泛型类型，告诉Jackson T的具体类型
    JavaType indexedDataType = csvMapper.getTypeFactory()
            .constructParametricType(IndexedData.class, dataType);
    
    CsvSchema csvSchema = csvMapper.typedSchemaFor(cls)
            .withHeader()
            .withStrictHeaders(true);
    
    return csvMapper.readerFor(cls)
            .with(csvSchema)
            .withType(indexedDataType)
            .readValues(csvFile)
            .readAll();
}

调用的时候就可以指定T的类型了，比如T是String，R是UserData：

File csvFile = new File("data.csv");
List<UserData> dataList = readFile(csvFile, UserData.class, String.class);

4. CSV数据格式不规范（含逗号、引号） #

如果CSV里的字段包含逗号、引号这类特殊字符，默认的解析规则会出错，导致字段被拆分或者解析异常。

解决办法：

• 自定义CsvSchema的分隔符、引号和转义字符规则：

CsvSchema csvSchema = csvMapper.typedSchemaFor(cls)
        .withHeader()
        .withStrictHeaders(true)
        .withColumnSeparator(',') // 指定CSV的分隔符
        .withQuoteChar('"') // 指定包裹字段的引号字符
        .withEscapeChar('\\'); // 指定转义字符，处理引号内的特殊字符

最后给你一个完整的可运行示例：
假设你的实体类是这样的：

// 泛型父类
public abstract class IndexedData<T> {
    @JsonProperty("INDEX_ID")
    private int index;
    @JsonProperty("DATA")
    private T data;

    // getter和setter
    public int getIndex() { return index; }
    public void setIndex(int index) { this.index = index; }
    public T getData() { return data; }
    public void setData(T data) { this.data = data; }
}

// 子类
public class UserData extends IndexedData<String> {
    @JsonProperty("USER_NAME")
    private String userName;

    public String getUserName() { return userName; }
    public void setUserName(String userName) { this.userName = userName; }
}

读取CSV的方法调用后，就能正确把CSV内容转换成List<UserData>啦！

内容的提问来源于stack exchange，提问作者Léo R.