【problem】解决“Cannot deserialize instance of `java.util.ArrayList` out of START_OBJECT token”错误

在使用Java进行序列化和反序列化时，我们时常会遇到各种各样的错误，其中“Cannot deserialize instance of java.util.ArrayList out of START_OBJECT token”错误是一个比较常见的问题。这个错误通常发生在使用Jackson库进行JSON数据反序列化时，尤其是在处理集合类型的数据时。

错误原因

这个错误的本质是因为Jackson在尝试将JSON字符串解析为Java对象时，预期得到一个数组（如ArrayList），但实际上得到了一个对象。这意味着你的JSON数据结构与Java类的结构不匹配。JSON中的"START_OBJECT"标记表示它将遇到一个对象，而Jackson期望的是一个数组。

例如，考虑以下Java类：

public class User {
    private String name;
    private int age;

    // getters and setters
}

如果你有如下的JSON数据：

{
    "users": {
        "name": "John",
        "age": 30
    }
}

在这个JSON中，users是一个对象，而不是一个数组。如果你试图反序列化这个JSON到一个List类型，那么就会得到上述错误。

如何解决

要解决这个问题，首先需要确保JSON结构与Java类的结构相匹配。

解决方案一：调整JSON结构

如果可以修改JSON结构，确保users字段是一个数组。例如：

{
    "users": [
        {
            "name": "John",
            "age": 30
        },
        {
            "name": "Jane",
            "age": 25
        }
    ]
}

随后，反序列化代码可以如下：

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;

public class Main {
    public static void main(String[] args) throws Exception {
        String json = "{ \"users\": [ { \"name\": \"John\", \"age\": 30 }, { \"name\": \"Jane\", \"age\": 25 } ] }";
        ObjectMapper objectMapper = new ObjectMapper();
        UserList userList = objectMapper.readValue(json, UserList.class);

        for (User user : userList.getUsers()) {
            System.out.println("Name: " + user.getName() + ", Age: " + user.getAge());
        }
    }
}

class UserList {
    private List<User> users;

    public List<User> getUsers() {
        return users;
    }

    public void setUsers(List<User> users) {
        this.users = users;
    }
}

解决方案二：修改Java类

如果无法修改JSON结构，那么必须调整Java类以匹配JSON结构。在这种情况下，你可以定义一个新的类来表示users字段：

public class UserWrapper {
    private User users;

    // getters and setters
}

然后，反序列化时，你可以直接读取到UserWrapper对象：

public class Main {
    public static void main(String[] args) throws Exception {
        String json = "{ \"users\": { \"name\": \"John\", \"age\": 30 } }";
        ObjectMapper objectMapper = new ObjectMapper();
        UserWrapper userWrapper = objectMapper.readValue(json, UserWrapper.class);

        System.out.println("Name: " + userWrapper.getUsers().getName() + ", Age: " + userWrapper.getUsers().getAge());
    }
}

总结

“Cannot deserialize instance of java.util.ArrayList out of START_OBJECT token”错误通常是由于JSON结构与Java类结构不匹配引起的。可以通过修改JSON数据结构或调整Java类来解决此错误。理解JSON的结构，并确保与Java对象保持一致，是避免此类错误的关键。在使用Jackson库时，合理设计数据模型和JSON结构，可以有效提高开发效率，减少错误。