当前位置：首页 > 后端开发 > 正文

如何用Java读取JSON？

admin
后端开发
2025-06-15
6

在Java中读取JSON通常借助第三方库如Jackson或Gson，通过创建ObjectMapper（Jackson）或JsonParser（Gson），可将JSON字符串解析为Java对象或树状结构，实现数据访问与操作。

在Java中读取JSON数据是常见任务,尤其在Web开发、API交互或数据存储场景，以下是详细方法及最佳实践，涵盖主流库的使用和注意事项。

为什么需要JSON解析库？

JSON（JavaScript Object Notation）是轻量级数据交换格式，Java原生不支持JSON解析，需借助第三方库实现高效处理，主流库有：

Gson（Google开发）：简单易用，适合初学者。
Jackson：高性能，功能全面，企业级应用首选。
org.json：轻量级，但功能较少。

推荐选择 Gson 或 Jackson（本文以Gson为主，Jackson为辅）。

如何用Java读取JSON？第1张

使用Gson读取JSON

步骤1：添加依赖

Maven项目（pom.xml）：

<dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.10.1</version> </dependency>

Gradle项目（build.gradle）：

如何用Java读取JSON？第2张

步骤2：解析JSON字符串 → Java对象

import com.google.gson.Gson; public class User { private String name; private int age; // 必须有无参构造函数和Getter/Setter } // 解析示例 String json = "{"name":"张三","age":25}"; Gson gson = new Gson(); User user = gson.fromJson(json, User.class); System.out.println(user.getName()); // 输出：张三

步骤3：解析JSON文件 → Java对象

import java.io.FileReader; try (FileReader reader = new FileReader("data.json")) { User user = gson.fromJson(reader, User.class); System.out.println(user.getAge()); } catch (Exception e) { e.printStackTrace(); }

步骤4：处理复杂结构（嵌套对象/数组）

JSON示例：

{ "team": "开发组", "members": [ {"name": "张三", "skills": ["Java", "SQL"]}, {"name": "李四", "skills": ["Python", "Docker"]} ] }

Java代码：

import com.google.gson.reflect.TypeToken; import java.util.List; class Member { private String name; private List<String> skills; // Getter/Setter } class Team { private String team; private List<Member> members; // Getter/Setter } // 解析嵌套JSON Team team = gson.fromJson(json, Team.class); List<Member> members = team.getMembers(); System.out.println(members.get(0).getSkills()); // 输出：[Java, SQL]

使用Jackson读取JSON（替代方案）

步骤1：添加依赖

<dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.16.1</version> </dependency>

步骤2：基础解析

import com.fasterxml.jackson.databind.ObjectMapper; ObjectMapper mapper = new ObjectMapper(); User user = mapper.readValue(json, User.class); // 解析字符串 User userFromFile = mapper.readValue(new File("data.json"), User.class); // 解析文件

常见问题及解决

字段不匹配
- 问题：JSON键名与Java字段名不一致（如 user_name vs userName）。
- 解决：
  - Gson：用 @SerializedName 注解 public class User { @SerializedName("user_name") private String userName; }
  - Jackson：用 @JsonProperty("user_name")
- 解析异常
  - 错误：JsonSyntaxException（Gson）或 JsonProcessingException（Jackson）。
  - 处理： try { // 解析代码 } catch (JsonSyntaxException e) { System.err.println("JSON格式错误：" + e.getMessage()); }
  - 处理未知字段
    - Gson默认忽略未知字段,如需严格匹配，通过 GsonBuilder 配置： Gson gson = new GsonBuilder().setLenient().create(); // 宽松模式（默认） Gson strictGson = new GsonBuilder().disableHtmlEscaping().create(); // 严格模式