使用Jackson CsvMapper序列化/反序列化嵌套POJO的CSV格式问题

看起来你遇到的是Jackson CSV模块处理@JsonUnwrapped前缀时的字段名拼接问题——当前生成的表头把前缀||和分隔符|混在一起，导致出现|||id这种不符合预期的列名。下面是两种可行的解决方案：

首先，确认你使用的是Jackson 2.13及以上版本（较新版本对CSV模块的@JsonUnwrapped支持更完善）。然后按照以下方式配置CsvMapper和CsvSchema：

// 初始化CsvMapper
CsvMapper csvMapper = new CsvMapper();

// 生成对应User类的Schema，指定分隔符为|并包含表头
CsvSchema csvSchema = csvMapper.schemaFor(User.class)
        .withSeparator('|')
        .withHeader()
        .withQuoteChar(CsvSchema.NO_QUOTE_CHAR); // 如果不需要引号可以加上

// 准备测试数据
List<User> users = Arrays.asList(
        new User("New User", new Role(1L, "User"), "newuser@gmail.com"),
        new User("New User2", new Role(1L, "User"), "newuser2@gmail.com"),
        new User("New User3", new Role(1L, "User"), "newuser3@gmail.com")
);

// 序列化为CSV字符串
String csvOutput = csvMapper.writer(csvSchema).writeValueAsString(users);

这样配置后，@JsonUnwrapped(prefix = "||")会正确地将前缀拼接到Role的字段名前，生成的表头应该是：

name|email||id||name

对应的内容行是：

New User|newuser@gmail.com|1|User
New User2|newuser2@gmail.com|1|User
New User3|newuser3@gmail.com|1|User

注意：如果你的User和Role类存在字段名重复（比如两者都有name），Jackson会自动处理，但表头会出现两个name（一个是User的，一个是Role的带前缀的），这是正常现象。

如果无法升级Jackson版本，可以手动定义CSV的列名，确保前缀正确应用：

1. 先给Role的字段加上带前缀的@JsonProperty注解：

public class Role implements Serializable {
    @JsonProperty("||id")
    private Long id;
    @JsonProperty("||name")
    private String name;

    // 构造器、getter、setter省略
}

2. 修改User类，去掉@JsonUnwrapped，确保Role的字段能被正确序列化：

public class User implements Serializable {
    private String name;
    private Role role;
    private String email;

    // 构造器、getter、setter省略
}

3. 手动构建CsvSchema：

CsvSchema csvSchema = CsvSchema.builder()
        .addColumn("name")
        .addColumn("email")
        .addColumn("||id")
        .addColumn("||name")
        .withSeparator('|')
        .withHeader()
        .build();

// 后续序列化代码同方案一

这种方式完全手动控制列名，能确保前缀符合你的预期，不受Jackson版本的限制。

• 如果你需要输出的内容中，Role字段的取值前也带有||（比如New User|newuser@gmail.com||1||User），那其实是对CSV格式的误解——CSV的分隔符是|，列名的前缀||只是标识字段归属，内容只需要对应列的取值即可，不需要额外添加分隔符。如果确实需要这样的格式，你可以自定义序列化器，在Role字段的取值前拼接||，但这会破坏CSV的规范性，不建议这么做。

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