本文详细介绍了在 Java 中使用 Gson 库读取和解析 JSON 数据，特别是如何处理常见的 `JsonSyntaxException`。文章通过一个具体的 DTO 映射错误案例，深入讲解了 JSON 对象和数组与 Java 类的正确对应关系，并提供了针对单个大型 JSON 文件和多行 ndJSON 文件的完整解析示例代码及最佳实践，旨在帮助开发者避免常见错误并提高数据处理效率。
引言：理解 JSON 与 ndJSON
JSON (JavaScript Object Notation) 是一种轻量级的数据交换格式，广泛应用于前后端数据传输和文件存储。ndJSON (Newline Delimited JSON)，即行分隔 JSON，是 JSON 的一种变体，其特点是每行包含一个独立的 JSON 对象，行与行之间通过换行符分隔。这种格式特别适用于处理大数据流，例如日志文件或数据导入导出。
在 Java 中，Google 的 Gson 库是处理 JSON 数据的常用工具。它能够将 JSON 字符串或流转换为 Java 对象，反之亦然。然而，不正确的 Java 对象（Data Transfer Object, DTO）映射常常会导致解析错误。
问题分析：JsonSyntaxException 的根源
当尝试使用 Gson 将 JSON 数据映射到 Java 对象时，如果 DTO 的结构与 JSON 的实际结构不匹配，就可能抛出 com.google.gson.JsonSyntaxException。一个常见的错误是 java.lang.IllegalStateException: Expected BEGIN_ARRAY but was BEGIN_OBJECT，这意味着 Gson 期望在 JSON 中找到一个数组（[），但实际上却遇到了一个对象（{）。
立即学习“Java免费学习笔记（深入）”；
让我们通过一个具体的例子来理解这个问题。假设我们有一个 JSON 文件，内容如下（为清晰起见，此处展示一个完整的 JSON 对象，而非严格意义上的多行 ndJSON）：
{
"Top-level":{
"customer_no":"1",
"created":"2019-03-27 14:24:54",
"last_visited_day_time":null, 
