Java中使用Jackson正确反序列化JSON数组到嵌套类列表的完整教程

本文详解如何用Jackson将JSON数组准确反序列化为Java嵌套类对象列表，重点解决因类结构设计不当（如非静态内部类、类型不匹配）导致的MismatchedInputException异常，并提供可直接运行的代码示例与最佳实践。

本文详解如何用jackson将json数组准确反序列化为java嵌套类对象列表，重点解决因类结构设计不当（如非静态内部类、类型不匹配）导致的`mismatchedinputexception`异常，并提供可直接运行的代码示例与最佳实践。

在Java中使用Jackson处理JSON响应时，一个常见但易被忽视的错误是：将JSON数组（以[开头）误当作单个对象进行反序列化。正如问题中所示，服务端返回的是一个包含多个对象的JSON数组，而开发者却尝试将其直接映射到顶层类 EmploymentSalaryTypeResponse（一个普通类），而非其内部Root类的集合——这正是MismatchedInputException: Cannot deserialize value of type ... from Array value的根本原因。

要彻底解决该问题，需从类设计规范和反序列化调用方式两方面协同优化：

✅ 一、修正Java类结构：必须使用静态内部类 + 正确注解

非静态内部类（non-static inner class）隐式持有对外部类实例的引用，Jackson无法实例化它（会抛出InstantiationException）。因此，所有用于JSON映射的嵌套类必须声明为static。同时，应为每个数据承载类添加@JsonIgnoreProperties(ignoreUnknown = true)，以安全忽略JSON中可能新增但Java类尚未定义的字段，增强健壮性。

以下是推荐的、生产就绪的类定义：

立即学习“Java免费学习笔记（深入）”；

package com.ls.json.pack;

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
public class EmploymentSalaryTypeResponse {

    @Data
    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class Fields {
        private String type;
    }

    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class Root {
        private int index;
        private String source_list_name;
        private boolean allow_multiple_account_associates;
        private int source_list_index;
        private Fields fields;
        private boolean is_editable;
        private boolean allow_associates;
    }
}

⚠️ 注意事项：

Felvin

AI无代码市场，只需一个提示快速构建应用程序

下载

• Fields 和 Root 均为 public static class，不可省略 static；
• @Data 已隐含 @Getter/@Setter/@ToString/@EqualsAndHashCode，无需额外声明；
• @AllArgsConstructor 和 @NoArgsConstructor 对 Root 是必需的：Jackson默认通过无参构造器创建实例，若字段全为final或未提供无参构造器，则反序列化失败。

✅ 二、正确执行反序列化：明确指定泛型集合类型

JSON是数组（[...]），目标类型必须是 List<Root>，而非 Root 或 EmploymentSalaryTypeResponse。Jackson无法自动推断泛型信息，必须借助 TypeReference 显式声明：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.type.TypeReference;
import java.util.List;

public class JsonDemo {
    public static void main(String[] args) throws JsonProcessingException {
        String json = "[{" +
                "\"index\":514042," +
                "\"source_list_name\":\"insurance_group\"," +
                "\"allow_multiple_account_associates\":false," +
                "\"source_list_index\":10078," +
                "\"fields\":{\"type\":\"e212\"}," +
                "\"is_editable\":false," +
                "\"allow_associates\":false" +
                "},{\"is_editable\":true,\"fields\":{\"type\":\"i120\"},\"allow_associates\":false,\"allow_multiple_account_associates\":false,\"index\":533402}]";

        ObjectMapper mapper = new ObjectMapper();
        // ✅ 关键：使用 TypeReference 指定 List<EmploymentSalaryTypeResponse.Root>
        TypeReference<List<EmploymentSalaryTypeResponse.Root>> typeRef =
                new TypeReference<List<EmploymentSalaryTypeResponse.Root>>() {};

        List<EmploymentSalaryTypeResponse.Root> result = mapper.readValue(json, typeRef);
        System.out.println("成功解析 " + result.size() + " 条记录");
        result.forEach(System.out::println);
    }
}

✅ 三、Spring Web环境下的简化方案（推荐）

若在Spring Boot项目中调用REST API（如使用RestTemplate或WebClient），可完全避免手动解析——直接将方法返回类型声明为 List<Root>：

// Spring MVC Controller 示例
@GetMapping("/types")
public ResponseEntity<List<EmploymentSalaryTypeResponse.Root>> getTypes() {
    return restTemplate.getForEntity("https://api.example.com/types", 
        new ParameterizedTypeReference<List<EmploymentSalaryTypeResponse.Root>>() {});
}

或使用 WebClient（更现代）：

webClient.get()
    .uri("/types")
    .retrieve()
    .bodyToFlux(EmploymentSalaryTypeResponse.Root.class) // 自动流式解析为 Root 对象
    .collectList()
    .block(); // 返回 List<Root>

? 总结

遵循以上三点，即可稳定、高效地完成JSON数组到Java对象列表的反序列化，彻底规避MismatchedInputException。