如何在无注解下用Jackson将List<User>序列化为单个User对象？

问题原因 #

之前的代码编译错误是因为Java泛型擦除机制，List<User>.class这种写法不合法——运行时JVM会擦除泛型类型信息，Jackson无法直接识别特定泛型参数的List类型。

可行解决方案 #

方案1：自定义Group类的序列化器 #

直接针对Group类编写序列化逻辑，手动处理user字段，将List转为第一个元素：

public class GroupSerializer extends StdSerializer<Group> {
    public GroupSerializer() {
        super(Group.class);
    }

    @Override
    public void serialize(Group group, JsonGenerator gen, SerializerProvider provider) throws IOException {
        gen.writeStartObject();
        // 处理user字段：判断List非空后取第一个元素，否则输出null
        List<User> users = group.user;
        if (users != null && !users.isEmpty()) {
            provider.defaultSerializeValue(users.get(0), gen);
        } else {
            gen.writeNullField("user");
        }
        // 若Group有其他字段，需在此处一并序列化，示例：
        // provider.defaultSerializeValue(group.otherField, gen);
        gen.writeEndObject();
    }
}

注册序列化器到ObjectMapper：

ObjectMapper mapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.addSerializer(Group.class, new GroupSerializer());
mapper.registerModule(module);

// 测试序列化
Group group = new Group();
List<User> users = new ArrayList<>();
users.add(new User("Admin"));
group.user = users;
String json = mapper.writeValueAsString(group);
// 输出结果：{"user":{"title":"Admin"}}

方案2：使用BeanSerializerModifier修改字段序列化逻辑 #

若Group类有多个字段，不想重写整个类的序列化逻辑，可以用BeanSerializerModifier单独修改user字段的序列化方式：

public class ListToUserModifier extends BeanSerializerModifier {
    @Override
    public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) {
        // 仅处理Group类的user字段
        if (beanDesc.getBeanClass() == Group.class) {
            for (BeanPropertyWriter writer : beanProperties) {
                if ("user".equals(writer.getName())) {
                    // 替换字段的序列化器
                    writer.assignSerializer(new StdSerializer<List<User>>(List.class) {
                        @Override
                        public void serialize(List<User> users, JsonGenerator gen, SerializerProvider provider) throws IOException {
                            if (users != null && !users.isEmpty()) {
                                provider.defaultSerializeValue(users.get(0), gen);
                            } else {
                                gen.writeNull();
                            }
                        }
                    });
                }
            }
        }
        return beanProperties;
    }
}

注册到ObjectMapper：

ObjectMapper mapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.setSerializerModifier(new ListToUserModifier());
mapper.registerModule(module);

方案3：用JavaType注册泛型List的序列化器 #

如果需要全局将所有List<User>转为单个User对象，可以通过JavaType指定泛型类型，解决泛型擦除的问题：

// 定义转换器（补充空值判断避免空指针）
public class ListUserConverter extends StdConverter<List<User>, User> {
    @Override
    public User convert(List<User> users) {
        return users != null && !users.isEmpty() ? users.get(0) : null;
    }
}

注册泛型序列化器：

ObjectMapper mapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
// 构造List<User>的JavaType，明确泛型参数
JavaType listUserType = TypeFactory.defaultInstance().constructParametricType(List.class, User.class);
module.addSerializer(listUserType, new StdDelegatingSerializer(new ListUserConverter()));
mapper.registerModule(module);

适用场景说明 #

• 方案1、2：仅针对Group类的user字段生效，不会影响其他地方的List<User>序列化，适合局部需求。
• 方案3：全局生效，所有List<User>类型都会被序列化为单个User对象，适合全局统一需求。

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