使用Gson解析JSON文件报错：Expected BEGIN_ARRAY but was BEGIN_OBJECT

我一眼就看出问题出在哪啦！你遇到的Expected BEGIN_ARRAY but was BEGIN_OBJECT错误，核心原因是JSON的根结构和你告诉Gson要解析的类型不匹配。

先看你的JSON结构 #

你的test1.json根是一个对象，里面包含一个EventRecords字段，值才是数组：

{ 
  "EventRecords": [ 
    { 
      "eventVersion": "2.0", 
      "eventSource": "aws:s3", 
      "awsRegion": "us-east-1", 
      "eventTime": "2018-05-10T17:10:01.420Z", 
      "eventName": "ObjectCreated:Put" 
    } 
  ] 
}

但你的代码里，却用TypeToken<List<Record>>告诉Gson：“帮我解析成一个Record对象的数组”——这就矛盾了！Gson一读到JSON开头的{（BEGIN_OBJECT），但你说要读[（BEGIN_ARRAY），自然就报错了。

修正步骤 #

只需要修改GsonEncoder里的解析代码，把解析目标类型换成SNSEventRecords.class就好，因为这个类正好对应JSON的根对象结构：

修正后的GsonEncoder.java

import java.io.BufferedReader;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileReader;
import java.util.List;
import com.google.gson.Gson;
import com.uberops.validator.gson.dto.Record;
import com.uberops.validator.gson.dto.SNSEventRecords;

public class GsonEncoder {
    public void jsonEncoder(String filePath) throws FileNotFoundException {
        Gson gson = new Gson();
        // 用BufferedReader或者JsonReader都可以，这里用BufferedReader更简洁
        BufferedReader reader = new BufferedReader(new FileReader(filePath));
        // 关键：把解析类型换成SNSEventRecords.class，对应JSON的根对象
        SNSEventRecords eventRecords = gson.fromJson(reader, SNSEventRecords.class);
        List<Record> records = eventRecords.getEventRecords();
        System.out.println("\n\nEventRecords\n\n" + records.toString());
    }

    public static void main(String[] args) throws FileNotFoundException {
        GsonEncoder obj2 = new GsonEncoder();
        File f2 = new File("/Users/test/Desktop/test1.json");
        obj2.jsonEncoder(f2.getAbsolutePath());
    }
}

额外说明 #

你提到“移除EventRecords的引号（不符合JSON规范）能成功”，其实那是因为修改后的JSON根变成了数组，正好匹配你代码里的List<Record>类型，但这是违规的JSON，肯定不能这么干。正确的做法就是让解析类型和JSON结构严格对应：

• JSON根是对象 → 用对应的Java类（SNSEventRecords）解析
• JSON根是数组 → 用List<XXX>或者数组类型解析

另外，你的SNSEventRecords类里的字段名EventRecords和JSON里的键完全一致，Gson可以自动映射，不需要额外配置，这点是没问题的。

内容的提问来源于stack exchange，提问作者nad87563