如何解决Jackson反序列化嵌套JSON字符串无法转为对象列表的问题

问题根因 #

报错的核心原因是接口返回的hobby_list是字符串类型值（内部为转义后的JSON数组文本），而实体类对应字段声明为List<Hobby>，Jackson默认不会自动对字符串内部的JSON文本做二次反序列化，因此触发了类型不匹配异常。

方案对比与最优实践 #

三种实现方案适用于不同场景，优先顺序如下：

1. 仅个别字段存在嵌套JSON字符串：字段加注解（绝大多数场景最优） #

侵入性最小，不会影响全局序列化逻辑，不会引入非预期的转换风险，是首选方案。
实现步骤：

• 编写通用的JSON字符串转集合反序列化器：

public class JsonStringListDeserializer<T> extends JsonDeserializer<List<T>> {
    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();

    @Override
    public List<T> deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {
        String jsonContent = jsonParser.getText();
        return OBJECT_MAPPER.readValue(jsonContent, new TypeReference<List<T>>() {});
    }
}

• 在对应字段上添加反序列化注解即可：

@JsonProperty("hobby_list")
@JsonDeserialize(using = JsonStringListDeserializer.class)
private List<Hobby> hobbyList;

Jackson 2.12及以上版本可以直接使用官方提供的FromStringDeserializer子类，无需自行实现基础反序列化逻辑。

2. 项目大量接口返回嵌套JSON字符串：全局配置 #

如果项目中存在大量同类返回结构，可通过全局配置统一处理，避免每个字段加注解的重复操作。但该方案风险较高，需要全量回归测试避免非预期类型转换。
配置示例：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper customObjectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule module = new SimpleModule();
        // 注册全局的字符串转集合反序列化器
        module.addDeserializer(List.class, new JsonStringListDeserializer<>());
        objectMapper.registerModule(module);
        return objectMapper;
    }
}

3. 自定义反序列化器：通用能力封装 #

如果不同业务字段需要适配不同的嵌套JSON结构，可将反序列化器做泛型化封装，复用解析逻辑，避免重复编码。

最优建议 #

如果具备接口调整权限，优先协调接口提供方将hobby_list直接返回为JSON数组而非转义字符串，从根源上避免额外的序列化适配逻辑，是成本最低的解决方案。

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