本文旨在解决java中使用gson库解析json文件时常见的`jsonsyntaxexception: expected begin_array but was begin_object`错误。核心在于强调json数据结构（对象或数组）与java dto（数据传输对象）中对应字段类型必须严格匹配。教程将通过案例分析、正确模型设计、代码示例及ndjson文件处理方法，指导开发者实现高效、无错的json反序列化。
引言：理解JSON与Java对象映射的挑战
JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，在现代Web服务和数据处理中扮演着核心角色。在Java应用中，我们经常需要将JSON数据反序列化为Java对象，以便于程序内部处理。Gson是Google提供的一个强大的Java库，用于Java对象和JSON数据之间的序列化和反序列化。然而，在将复杂的JSON结构映射到Java对象时，如果不遵循严格的类型匹配规则，很容易遇到JsonSyntaxException等运行时错误。
案例分析：Expected BEGIN_ARRAY but was BEGIN_OBJECT异常解析
当使用Gson解析JSON时，com.google.gson.JsonSyntaxException: java.lang.IllegalStateException: Expected BEGIN_ARRAY but was BEGIN_OBJECT是一个常见的错误。这个异常清晰地指出了问题所在：Gson在解析JSON时，期望遇到一个数组的开始（[），但实际上却遇到了一个对象的开始（{）。这通常意味着您的Java DTO模型与实际的JSON结构不匹配。
让我们来看一个具体的例子。假设有以下JSON数据片段：
{ "Top-level":{ "customer_no":"1", "created":"2019-03-27 14:24:54" }, "profile":{ "salutation":"Mr", "first_name":"Veronica" }, "phone":{ "home_phone":null }, "addresses":[ { "address_id":"1", "city":"Calder" } ], "orders":{ "placed_orders_count":2, "0":{ "order_id":"000000001" } }, "customs":[ ]}
以及一个尝试解析上述JSON的Java DTO：
立即学习“Java免费学习笔记（深入）”；
public class CustomerFeedDTO { private ArrayList topLevel; private ArrayList profile; private ArrayList phone; private ArrayList addresses; private ArrayList orders; private ArrayList customs; // Getters and setters}
当尝试使用Gson.fromJson(reader, CustomerFeedDTO.class)进行反序列化时，便会抛出Expected BEGIN_ARRAY but was BEGIN_OBJECT at line 1 column 138 path $.profile异常。
原因分析：仔细比对JSON结构与CustomerFeedDTO会发现：
JSON中的”Top-level”是一个JSON对象（以{开头）。JSON中的”profile”是一个JSON对象（以{开头）。JSON中的”phone”是一个JSON对象（以{开头）。JSON中的”orders”是一个JSON对象（以{开头）。然而，在CustomerFeedDTO中，topLevel, profile, phone, orders字段都被声明为ArrayList。
Gson在解析到”profile”字段时，发现JSON中是一个对象，但DTO中却定义为一个列表，因此抛出了类型不匹配的异常。
正确的数据模型（DTO）设计
解决上述问题的关键在于确保Java DTO的字段类型与JSON数据的结构严格匹配。
核心原则：JSON结构与Java类型匹配
JSON对象 { … }：应映射到Java的自定义类（POJO – Plain Old Java Object）或 Map 类型。使用自定义类通常是更好的选择，因为它提供了更强的类型安全性和代码可读性。JSON数组 [ … ]：应映射到Java的 List 或 T[] 类型。其中 T 是数组元素的Java类型。JSON基本类型（字符串、数字、布尔值、null）：应映射到Java的 String、int/Integer、double/Double、boolean/Boolean 等基本类型或其包装类。
修正后的CustomerFeedDTO
根据上述原则，我们可以修正CustomerFeedDTO如下：
import java.util.ArrayList;import java.util.Map; // 需要导入Mappublic class CustomerFeedDTO { // "Top-level" 在JSON中是对象，应映射为Map或自定义类 private Map topLevel; // "profile" 在JSON中是对象，应映射为Map或自定义类 private Map profile; // "phone" 在JSON中是对象，应映射为Map或自定义类 private Map phone; // "addresses" 在JSON中是数组，映射为ArrayList是正确的 private ArrayList addresses; // "orders" 在JSON中是对象，应映射为Map或自定义类 private Map orders; // "customs" 在JSON中是数组，映射为ArrayList是正确的 private ArrayList customs; // Getters and setters (省略，但实际开发中应包含) public Map getTopLevel() { return topLevel; } public void setTopLevel(Map topLevel) { this.topLevel = topLevel; } public Map getProfile() { return profile; } public void setProfile(Map profile) { this.profile = profile; } public Map getPhone() { return phone; } public void setPhone(Map phone) { this.phone = phone; } public ArrayList getAddresses() { return addresses; } public void setAddresses(ArrayList addresses) { this.addresses = addresses; } public Map getOrders() { return orders; } public void setOrders(Map orders) { this.orders = orders; } public ArrayList getCustoms() { return customs; } public void setCustoms(ArrayList customs) { this.customs = customs; }}
通过将topLevel, profile, phone, orders字段的类型从ArrayList更改为Map，我们使得DTO的结构与JSON数据完全匹配，从而解决了JsonSyntaxException。
音疯
音疯是昆仑万维推出的一个AI音乐创作平台，每日可以免费生成6首歌曲。
146 查看详情 
更佳实践：使用具体POJO类
虽然使用Map可以解决类型匹配问题，但在实际项目中，为每个JSON对象创建具体的Java POJO类是更推荐的做法。这提供了更好的类型安全、代码可读性、IDE自动补全支持以及更强的可维护性。
例如，可以为Top-level、Profile、Phone、Order等创建独立的POJO类：
// TopLevel.javapublic class TopLevel { private String customer_no; private String created; private String last_visited_day_time; // 对应JSON中的null private String login; // 对应JSON中的email // Getters and setters}// Profile.javapublic class Profile { private String salutation; private String title; private String company; private String job_title; private String first_name; private String last_name; private String name_suffix; private String gender; private String birthday; private String email; private String next_birthday; private String second_name; // Getters and setters}// Phone.javapublic class Phone { private String home_phone; private String business_phone; private String mobile_phone; private String fax_number; // Getters and setters}// Address.java (用于addresses数组中的元素)public class Address { private String address_id; private String title; // ... 其他地址字段 private String contact_phone; // Getters and setters}// OrdersContainer.java (因为orders内部有动态键名"0", "1"等，可以灵活处理)public class OrdersContainer { private int placed_orders_count; // 如果键名是数字，Gson默认会尝试映射到Map，或者可以自定义反序列化器 // 简便起见，这里仍使用Map，或者如果结构固定，可以定义OrderEntry类 private Map ordersMap; // 假设0, 1是订单ID // Getters and setters // 注意：Gson会尝试将"0"、"1"作为Map的键。 // 如果要更优雅地处理，可能需要自定义反序列化器，或者将这些订单视为List // 但这需要JSON结构是 [{}, {}] 而不是 {"0":{}, "1":{}} // 对于 {"0":{}, "1":{}} 这种结构，Map 是最直接的映射}// OrderEntry.javapublic class OrderEntry { private String order_id; private String order_date; // Getters and setters}// 最终的 CustomerFeedDTO 结构将是：public class CustomerFeedDTO { private TopLevel topLevel; private Profile profile; private Phone phone; private List addresses; // 使用 List 更具体 private OrdersContainer orders; // 使用 OrdersContainer private List
这种方法虽然需要定义更多的类，但提供了更清晰、更易于维护的代码结构。
Java代码实现：使用Gson进行JSON反序列化
有了正确的DTO模型，使用Gson读取JSON文件就变得非常简单和可靠。
import com.google.gson.Gson;import com.google.gson.JsonReader;import com.google.gson.JsonSyntaxException;import java.io.FileReader;import java.io.IOException;import java.util.ArrayList;import java.util.List;import java.util.Map;public class JsonFileReader { // 假设这是您的修正后的 CustomerFeedDTO // 这里使用Map作为内部对象的类型，以简化示例 public static class CustomerFeedDTO { private Map topLevel; // 使用Object以处理不同类型的值 private Map profile; private Map phone; private List<Map> addresses; // 地址是对象数组 private Map orders; private List
请确保将上述JSON数据保存为customer.json文件，并放置在Java程序能够访问的路径下。
处理ndJSON（Newline Delimited JSON）文件
原始问题标题提到了ndJSON文件。虽然我们分析的错误是针对单个JSON对象的结构映射，但ndJSON（Newline Delimited JSON）是一种特殊的文件格式，其中每行包含一个独立的JSON对象。如果您的文件确实是ndJSON格式，那么读取方式会有所不同。
例如，一个ndJSON文件可能看起来像这样：
{"id": 1, "name": "Alice"}{"id": 2, "name": "Bob"}{"id": 3, "name": "Charlie"}
处理ndJSON文件时，需要逐行读取文件，并对每一行进行独立的JSON解析。
import com.google.gson.Gson;import com.google.gson.JsonSyntaxException;import java.io.BufferedReader;import java.io.FileReader;import java.io.IOException;import java.util.ArrayList;import java.util.List;import java.util.Map;public class NdJsonFileReader {
以上就是Java中高效解析JSON/ndJSON文件：Gson与DTO模型匹配实践的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1075720.html
微信扫一扫 
支付宝扫一扫 
