Java中 Jackson JsonParseException 解析 JSON 语法错误怎么拦截

酷磊君_8505

酷磊君_8505

2026-07-19

725人浏览

原创

应捕获 jsonprocessingexception 而非仅 jsonparseexception,解析前做轻量预检(如正则筛根值、查非法字符),配置 objectmapper 提升容错(如允许注释、忽略未知字段),捕获后记录位置与原始片段并返回友好提示。

java中 jackson jsonparseexception 解析 json 语法错误怎么拦截

遇到 JsonParseException,说明 Jackson 在解析 JSON 字符串时碰到了不符合语法规范的内容,比如缺少引号、逗号错位、非法字符、乱码或裸字符串等。拦截的关键不是“阻止它发生”,而是**提前识别、捕获并安全处理**——不让异常穿透到上层逻辑,同时给出可定位的反馈。

明确捕获 JsonParseException 及其父类

Jackson 的 JsonParseException 是 JsonProcessingException 的子类,而后者是所有解析/序列化异常的顶层检查异常。实际编码中应直接 catch JsonProcessingException,覆盖更广(包括 JsonMappingException 等):

  • 不要只捕获 JsonParseException,否则漏掉字段映射失败等其他问题;
  • 推荐统一 catch JsonProcessingException,再用 instanceof 区分具体类型(如需差异化处理);
  • 若输入可能为 null 或空字符串,建议先校验,避免无意义解析触发异常。

解析前做轻量级预检

不是所有字符串都值得交给 ObjectMapper 解析。加一层低成本判断能减少异常抛出频率:

Wjs Uploading Video
Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载
  • 用正则粗筛:开头是否为 {、[、"、数字、true/false/null(JSON 合法根值);
  • 检查常见非法字符:如控制字符(\u0000-\u001F)、BOM 头(\uFEFF)、替换字符 \uFFFD;
  • 对已知格式的字段(如 ID、token),可先尝试用 String.trim().isEmpty() 或正则匹配,跳过 Jackson 解析。

配置 ObjectMapper 提升容错能力

部分语法错误可通过配置让 Jackson “容忍”而非报错,适用于非严格场景:

  • 允许单值作为数组:mapper.configure(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY, true);
  • 忽略未知字段(防 UnrecognizedPropertyException):mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
  • 允许注释(非标准但常见):mapper.configure(JsonParser.Feature.ALLOW_COMMENTS, true);
  • 允许未加引号的字段名(不推荐,仅调试用):mapper.configure(JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES, true)。

捕获后提供可操作的错误信息

日志或返回信息不能只写 e.getMessage(),要包含上下文才便于排查:

  • 记录原始 JSON 片段(取前 100 字符 + 出错位置 e.getLocation().getLineNr() 和 getColumnNr());
  • 区分是上游数据问题(如前端传参错误)还是本端读取编码错误(如 UTF-8 误作 ISO-8859-1);
  • 避免向客户端暴露原始异常堆栈,可包装为业务错误码 + 友好提示(如“请求数据格式错误,请检查 JSON 结构”)。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10337

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7462

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6532

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1124

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1356

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2709

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20031

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1195

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习