使用try-catch捕获JSON解析异常是Java处理非法JSON的关键,不同库如Jackson抛JsonProcessingException、Gson抛JsonSyntaxException、org.json抛JSONException,均需针对性捕获;常见原因包括格式错误、括号不匹配、类型不匹配等,通过预校验和日志记录可提升系统健壮性。

在Java中处理JSON解析异常,关键在于使用try-catch结构捕获解析过程中可能出现的异常。由于Java本身不内置JSON支持,通常会使用第三方库如Jackson、Gson或org.json等进行JSON操作。这些库在解析格式错误的JSON字符串时会抛出特定异常,必须通过try-catch机制妥善处理,防止程序崩溃。
常见JSON解析异常类型
不同库抛出的异常类型略有差异,了解这些异常有助于精准捕获和处理:
- Jackson:com.fasterxml.jackson.core.JsonProcessingException
- Gson:com.google.gson.JsonSyntaxException
- org.json:org.json.JSONException
这些异常通常由以下情况引发:JSON格式错误、缺少引号、括号不匹配、非法字符或数据类型不匹配等。
使用try-catch处理Jackson解析异常
Jackson是广泛使用的JSON处理库。当调用ObjectMapper的readValue方法解析非法JSON时,会抛出JsonProcessingException。应将其包裹在try-catch中:
立即学习“Java免费学习笔记(深入)”;
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"name\": \"Alice\", \"age\": }"; // 错误的JSON(age后无值)
try {
Person person = mapper.readValue(json, Person.class);
} catch (JsonProcessingException e) {
System.err.println("JSON解析失败:" + e.getMessage());
// 可记录日志、返回默认值或通知用户
}
捕获异常后,可根据业务需要做降级处理,比如使用默认对象或提示输入格式错误。
使用try-catch处理Gson解析异常
Gson库在解析无效JSON时会抛出JsonSyntaxException。使用方式如下:
Gson gson = new Gson();
String json = "{ \"title\": \"Book\", \"pages\": abc }"; // pages值非法
try {
Book book = gson.fromJson(json, Book.class);
} catch (JsonSyntaxException e) {
System.err.println("Gson解析出错:" + e.getMessage());
// 执行容错逻辑
}
建议在捕获异常时输出具体错误信息,便于排查问题来源。
通用错误处理建议
为提升代码健壮性,可采取以下实践:
- 始终对不可信来源的JSON字符串进行异常捕获
- 在catch块中记录详细日志,包括原始JSON内容(注意脱敏)
- 向调用方返回友好错误信息,避免暴露系统细节
- 对于关键业务,可结合预校验(如检查是否以{或[开头)减少异常发生
基本上就这些。只要在解析前预判可能出错,并用try-catch包围核心解析语句,就能有效控制JSON解析风险。










