如何使用Jackson将Map<String, String>转换为包含嵌套POJO、枚举等类型的目标POJO？

我明白你的困扰——Jackson默认处理Map<String, String>转POJO时，只会把字符串直接映射到对应类型，但遇到嵌套POJO或集合这类字段时，它不知道这些字符串其实是JSON序列化后的结果，自然会报错要String构造器。不过不用慌，咱们可以通过自定义通用反序列化器+POJO注解的方式解决，完全符合你“少写自定义代码、靠注解配置”的要求，还不用修改现有POJO的构造器。

问题根源拆解 #

你看到的错误本质是：words（JSON数组字符串）、properties（JSON对象字符串）这类字段，Jackson默认尝试把字符串直接赋值给List<String>或MyOtherPojo类型，这显然不匹配——它需要先把这些JSON字符串解析成对应的对象/集合，而不是直接当作字段值。

解决方案步骤 #

1. 编写通用JSON字符串反序列化器

这个反序列化器的作用是：如果输入是字符串，就自动把它解析成目标类型的对象/集合，而且它能从Jackson的上下文里获取你依赖注入的ObjectMapper，不用在POJO里硬依赖：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.deser.ContextualDeserializer;
import com.fasterxml.jackson.databind.type.JavaType;
import java.io.IOException;

public class JsonStringDeserializer<T> extends StdDeserializer<T> implements ContextualDeserializer {
    private JavaType targetType;

    // 无参构造器，用于Jackson初始化
    public JsonStringDeserializer() {
        super(Object.class);
    }

    // 带目标类型的构造器，用于上下文初始化
    private JsonStringDeserializer(JavaType targetType) {
        super(targetType);
        this.targetType = targetType;
    }

    @Override
    public T deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String jsonString = p.getText();
        if (jsonString == null || jsonString.isBlank()) {
            return null;
        }
        // 从上下文获取当前使用的ObjectMapper
        ObjectMapper mapper = (ObjectMapper) ctxt.getParser().getCodec();
        return mapper.readValue(jsonString, targetType);
    }

    @Override
    public JsonDeserializer<?> createContextual(DeserializationContext ctxt, BeanProperty property) throws JsonMappingException {
        // 获取当前字段的目标类型，创建对应类型的反序列化器实例
        JavaType type = property.getType();
        return new JsonStringDeserializer<>(type);
    }
}

2. 在POJO的目标字段上添加注解

只需要在那些存储JSON字符串的字段上加上@JsonDeserialize，指定用咱们刚才写的反序列化器就行，完全不用修改POJO的其他结构：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import lombok.Builder;
import lombok.Data;
import lombok.extern.jackson.Jacksonized;

@Data
@Builder
@Jacksonized // 加上这个注解，Jackson自动支持Builder模式，不用手动注册模块
public class MyPojo {
    private String name;
    private Color color;
    @JsonDeserialize(using = JsonStringDeserializer.class)
    private List<String> words;
    @JsonDeserialize(using = JsonStringDeserializer.class)
    private MyOtherPojo properties;
}

对于嵌套的MyOtherPojo，同样给嵌套字段加注解：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import lombok.Builder;
import lombok.Data;
import lombok.extern.jackson.Jacksonized;

@Data
@Builder
@Jacksonized
public class MyOtherPojo {
    private String text;
    private String moreText;
    @JsonDeserialize(using = JsonStringDeserializer.class)
    private MyOtherPojo moreProperties;
}

3. 确保ObjectMapper配置支持Builder模式

如果你用了Lombok的@Builder，记得要么给POJO加@Jacksonized（推荐），要么在你的DI配置里给ObjectMapper注册Builder支持模块：

objectMapper.registerModule(new ParameterNamesModule())
           .enable(MapperFeature.USE_BUILDER);

验证效果 #

现在你的MyPojoConverter不用改一行代码，直接运行就能正常转换了：

public class MyPojoConverter {
    private final ObjectMapper objectMapper;

    public MyPojoConverter(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    public MyPojo deserialize(Map<String, String> input) {
        return objectMapper.convertValue(input, MyPojo.class);
    }
}

Jackson会自动递归处理所有加了注解的字段：把JSON字符串解析成List<String>、MyOtherPojo甚至嵌套的MyOtherPojo，完全符合你的需求——以后新增字段只要加对注解，不用改转换逻辑。

备注：内容来源于stack exchange，提问作者mrog