Java如何读取JSON文件？

在Java开发中，读取JSON文件是常见需求，例如处理配置文件、API响应或数据交换，以下是三种主流库的详细实现方案,根据项目需求选择合适工具：

常用JSON处理库对比

具体实现步骤与代码

使用 org.json（原生轻量）

import org.json.JSONObject;
import org.json.JSONTokener;
import java.io.FileReader;
public class OrgJsonExample {
    public static void main(String[] args) {
        try (FileReader reader = new FileReader("data.json")) {
            JSONTokener tokener = new JSONTokener(reader);
            JSONObject json = new JSONObject(tokener);
            // 提取数据示例
            String name = json.getString("name");
            int age = json.getInt("age");
            System.out.println("Name: " + name + ", Age: " + age);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

关键点：

• JSONTokener 直接解析文件流
• 通过 getString()、getInt() 等方法按字段名取值
• 需添加依赖：implementation 'org.json:json:20251013'

使用 Gson（简洁易用）

import com.google.gson.Gson;
import java.io.FileReader;
// 定义与JSON结构匹配的Java类
class User {
    String name;
    int age;
    // Gson自动映射字段（需与JSON键名一致）
}
public class GsonExample {
    public static void main(String[] args) {
        Gson gson = new Gson();
        try (FileReader reader = new FileReader("data.json")) {
            User user = gson.fromJson(reader, User.class); // 自动绑定到对象
            System.out.println("Name: " + user.name + ", Age: " + user.age);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

优势：

• 自动将JSON映射到Java对象（反序列化）
• 支持复杂嵌套结构（如List、Map）
• 依赖：implementation 'com.google.code.gson:gson:2.10.1'

使用 Jackson（高性能首选）

import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.File;
public class JacksonExample {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        try {
            User user = mapper.readValue(new File("data.json"), User.class);
            System.out.println("Name: " + user.name + ", Age: " + user.age);
            // 流式API处理大文件（示例）
            /*
            JsonFactory factory = new JsonFactory();
            JsonParser parser = factory.createParser(new File("large.json"));
            while (parser.nextToken() != null) { ... } // 逐令牌解析
            */
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

进阶特性：

• 注解控制映射：@JsonProperty("json_key") 自定义字段名
• 流式API（JsonParser）处理GB级文件不占用全内存
• 依赖：implementation 'com.fasterxml.jackson.core:jackson-databind:2.15.0'

异常处理与最佳实践

1. 常见异常：

   • FileNotFoundException：文件路径错误
   • JsonSyntaxException（Gson）/JsonParseException（Jackson）：JSON格式错误
   • UnrecognizedPropertyException：JSON字段与Java类不匹配

2. 防御性代码建议：

   try {
       // 解析操作
   } catch (IOException e) {
       System.err.println("文件读取失败: " + e.getMessage());
   } catch (JsonProcessingException e) {
       System.err.println("JSON解析错误: " + e.getOriginalMessage());
   }

3. 性能优化：

   

   • 大文件优先用Jackson流式API
   • 频繁操作时复用 ObjectMapper / Gson 实例（线程安全）

总结选择建议

• 小型工具开发 → org.json（轻量无依赖）
• Android或常规业务 → Gson（API简洁）
• 高并发服务/复杂JSON → Jackson（性能+灵活性）

引用说明：本文代码基于官方文档最佳实践，Gson设计参考Google官方GitHub，Jackson优化方案来自FasterXML性能指南。