当前位置：首页 > 文章列表 > 文章 > java教程 > JSON反序列化为Java对象的常见问题与解决方法

JSON反序列化为Java对象的常见问题与解决方法

2025-11-19 21:01:44 0浏览收藏

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《JSON数组反序列化为Java对象：常见问题与解决方案》，聊聊，我们一起来看看吧！

JSON数组反序列化为Java对象：常见问题与解决方案

当尝试将JSON数组反序列化为单个Java对象时，常会遇到“Can't deserialize JSON array into class”错误。这通常是因为JSON字符串以数组形式（`[`开头）存在，而目标Java类型却是一个普通的类。本文将详细介绍两种有效的解决方案：将其反序列化为目标类的数组，或利用`TypeToken`反序列化为`ArrayList`，从而正确处理JSON数组结构。

理解JSON反序列化错误：数组与对象不匹配

在Java开发中，使用JSONB（或Jackson、Gson等）库进行JSON反序列化时，一个常见的陷阱是JSON结构与目标Java类型不匹配。当JSON字符串以 [ 开头，表示它是一个JSON数组，包含一个或多个JSON对象。然而，如果尝试将其直接反序列化为一个普通的Java类（例如 MocktailDto.class），反序列化器会因为类型不匹配而抛出 Can't deserialize JSON array into class 错误。

例如，给定的JSON字符串如下，它是一个包含单个 MocktailDto 对象的数组：

[
    {
        "id": 3,
        "name": "Mojito",
        "zutaten": [
            {
                "anzahl": 1,
                "id": 5,
                "name": "Rum"
            },
            {
                "anzahl": 1,
                "id": 6,
                "name": "GingerAle"
            }
        ]
    }
]

而代码中尝试将其反序列化为单个 MocktailDto 对象：

@POST
public Response createMocktail(String m){
    MocktailDto mocktail = jsonb.fromJson(m, MocktailDto.class); // 错误发生在这里
    return Response.ok(mocktailManager.createMocktail(mocktail)).build();
}

这种情况下，jsonb.fromJson(m, MocktailDto.class) 会失败，因为 m 是一个数组，而不是单个 MocktailDto 对象。

解决方案一：反序列化为目标类的数组

最直接的解决方案是将JSON数组反序列化为目标Java类的数组。这意味着如果JSON字符串是一个 MocktailDto 对象的数组，那么就应该将其反序列化为 MocktailDto[]。

示例代码：

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;

// 假设 MocktailDto 是你的Java类
// public class MocktailDto { ... }

public class JsonDeserializationExample {

    public static void main(String[] args) {
        String jsonString = "[{\"id\": 3,\"name\": \"Mojito\",\"zutaten\": [{\"anzahl\": 1,\"id\": 5,\"name\": \"Rum\"},{\"anzahl\": 1,\"id\": 6,\"name\": \"GingerAle\"}]}]";

        Jsonb jsonb = JsonbBuilder.create();

        // 将JSON数组反序列化为 MocktailDto 数组
        MocktailDto[] data = jsonb.fromJson(jsonString, MocktailDto[].class);

        // 如果你只需要数组中的第一个元素
        if (data != null && data.length > 0) {
            MocktailDto firstMocktail = data[0];
            System.out.println("成功反序列化第一个Mocktail: " + firstMocktail.getName());
            // 进一步处理 firstMocktail
        } else {
            System.out.println("JSON数组为空或反序列化失败。");
        }
    }
}

优点：

简单直观，适用于已知JSON数组中包含固定类型的对象。

注意事项：

反序列化后得到的是一个Java数组，需要通过索引（如 data[0]）来访问其中的元素。
如果JSON数组可能为空，需要进行空检查和长度检查。

解决方案二：反序列化为 ArrayList

当处理泛型集合（如 ArrayList）时，直接使用 ArrayList.class 作为目标类型通常不起作用，因为Java的类型擦除机制使得运行时无法获取泛型参数 MocktailDto 的具体信息。为了解决这个问题，需要使用 TypeToken（如 javax.json.bind.spi.TypeAdapter.TypeToken 或 com.google.gson.reflect.TypeToken，具体取决于使用的JSON库）。TypeToken 提供了一种在运行时保留泛型类型信息的方法。

示例代码：

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;
import javax.json.bind.spi.TypeAdapter; // 注意：这里可能需要根据具体jsonb实现调整TypeToken的导入
import java.lang.reflect.Type;
import java.util.ArrayList;

// 假设 MocktailDto 是你的Java类
// public class MocktailDto { ... }

public class JsonDeserializationExample {

    public static void main(String[] args) {
        String jsonString = "[{\"id\": 3,\"name\": \"Mojito\",\"zutaten\": [{\"anzahl\": 1,\"id\": 5,\"name\": \"Rum\"},{\"anzahl\": 1,\"id\": 6,\"name\": \"GingerAle\"}]}]";

        Jsonb jsonb = JsonbBuilder.create();

        // 使用 TypeToken 获取 ArrayList<MocktailDto> 的完整类型信息
        // 注意：这里使用的是 javax.json.bind.spi.TypeAdapter.TypeToken，
        // 如果你使用的是 Gson，则应使用 com.google.gson.reflect.TypeToken
        Type listType = new TypeAdapter.TypeToken<ArrayList<MocktailDto>>(){}.getType();

        ArrayList<MocktailDto> data = jsonb.fromJson(jsonString, listType);

        // 如果你只需要列表中的第一个元素
        if (data != null && !data.isEmpty()) {
            MocktailDto firstMocktail = data.get(0);
            System.out.println("成功反序列化第一个Mocktail: " + firstMocktail.getName());
            // 进一步处理 firstMocktail
        } else {
            System.out.println("JSON列表为空或反序列化失败。");
        }
    }
}

优点：