如何配置Jackson序列化嵌套对象集合并输出指定格式CSV

首先，咱们来拆解你的问题：你需要把ToSerialize对象序列化成扁平化的CSV，每个NestedObject的字段要带上objN.前缀，并且所有列和值按顺序输出。你之前的自定义序列化器报错，核心原因是上下文不对——你给List<NestedObject>写的序列化器，在Jackson处理objs字段时，已经处于"写入字段值"的阶段，这时候调用writeObjectField尝试写新的字段名，就会和当前的JSON/CSV生成上下文冲突，导致抛出那个异常。

下面是完整的解决方案，用Jackson的CSV模块来实现你要的格式：

1. 引入Jackson CSV依赖 #

如果用Maven，先添加依赖到pom.xml：

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-csv</artifactId>
    <version>2.15.2</version> <!-- 建议用最新稳定版 -->
</dependency>

2. 自定义ToSerialize的序列化器 #

我们需要直接控制整个ToSerialize对象的CSV输出，而不是单独处理objs字段。这样可以灵活生成带前缀的列名和对应的值：

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.ser.std.StdSerializer;
import com.fasterxml.jackson.dataformat.csv.CsvGenerator;
import java.io.IOException;
import java.util.List;

public class ToSerializeCsvSerializer extends StdSerializer<ToSerialize> {

    public ToSerializeCsvSerializer() {
        super(ToSerialize.class);
    }

    @Override
    public void serialize(ToSerialize value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        List<NestedObject> objs = value.objs;
        CsvGenerator csvGen = (CsvGenerator) gen;

        // 第一步：生成带前缀的表头
        for (int i = 0; i < objs.size(); i++) {
            int objIndex = i + 1;
            csvGen.writeFieldName("obj" + objIndex + ".intValue");
            csvGen.writeFieldName("obj" + objIndex + ".strValue");
        }
        csvGen.finishHeader(); // 结束表头，准备写入值行

        // 第二步：写入每个NestedObject的对应值
        for (NestedObject obj : objs) {
            csvGen.writeNumber(obj.intValue);
            csvGen.writeString(obj.strValue);
        }
    }
}

3. 配置并测试序列化 #

接下来配置CSV Mapper，注册自定义序列化器，然后测试：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.dataformat.csv.CsvMapper;
import com.fasterxml.jackson.dataformat.csv.CsvSchema;
import java.util.ArrayList;
import java.util.List;

public class CsvSerializationTest {
    public static void main(String[] args) throws Exception {
        // 构造测试数据
        List<NestedObject> objs = new ArrayList<>();
        objs.add(new NestedObject());
        objs.add(new NestedObject());
        ToSerialize toSerialize = new ToSerialize(objs);

        // 初始化CSV Mapper并注册序列化器
        CsvMapper csvMapper = new CsvMapper();
        csvMapper.registerModule(new com.fasterxml.jackson.databind.module.SimpleModule()
                .addSerializer(ToSerialize.class, new ToSerializeCsvSerializer()));

        // 配置CSV Schema（这里启用表头）
        CsvSchema schema = CsvSchema.emptySchema().withHeader();

        // 生成CSV字符串
        String csvOutput = csvMapper.writer(schema).writeValueAsString(toSerialize);
        System.out.println(csvOutput);
    }
}

输出结果 #

运行后会得到符合你需求的CSV：

obj1.intValue,obj1.strValue,obj2.intValue,obj2.strValue
0,"Hello world",0,"Hello world"

为什么之前的序列化器会报错？ #

你之前的序列化器是针对List<NestedObject>的，但当Jackson处理ToSerialize的objs字段时，它已经完成了字段名的写入（即写了objs），现在处于"写入字段值"的阶段。这时候你调用writeObjectField尝试写新的字段名（比如obj1），就违反了CSV/JSON的生成规则——值的位置不能写字段名，所以抛出了Can not write a field name, expecting a value异常。

通过直接序列化ToSerialize对象，我们跳过了对objs字段的默认处理，完全掌控了CSV的列生成和值写入逻辑，就不会有上下文冲突的问题了。

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