SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法

更新时间：2025年06月12日 16:37:32 作者：码农阿豪@新空间

在开发Spring Boot RESTful API时,客户端与服务端的数据交互通常使用JSON格式,然而,JSON解析错误（如400 Bad Request）是常见的开发问题之一,本文将通过一个实际案例,详细分析如何排查和解决JSON解析错误,并总结最佳实践,需要的朋友可以参考下

问题背景

1. 问题描述

开发者在调用本地Spring Boot接口时，遇到400 Bad Request错误：

curl --location 'http://localhost:8089/after/spider' \
--header 'Content-Type: application/json' \
--data '{
  "channelId": 100000132,
  "platformAccount": "yien",
  "platformPwd": "123456",
  "enName": "jinYiMu",
  "grabDays": 15,
  "aesPwd": "example"
}'

返回错误：

{
    "timestamp": "2025-06-12T03:04:50.459+00:00",
    "status": 400,
    "error": "Bad Request",
    "message": "JSON parse error: Unexpected character (' ' (code 160)): was expecting double-quote to start field name",
    "path": "/after/spider"
}

2. 错误分析

错误信息表明：

JSON解析失败，原因是存在非法字符 ' ' (code 160)（即HTML的空格  ）。
根本问题：JSON请求体中混入了不可见的特殊字符，导致Jackson解析失败。

解决方案

1. 手动重新输入JSON

问题原因：JSON可能是从网页、Word文档或富文本编辑器复制的，导致包含隐藏字符。
解决方法：手动重新输入JSON，避免复制粘贴：

{
  "channelId": 100000132,
  "platformAccount": "yien",
  "platformPwd": "123456",
  "enName": "jinYiMu",
  "grabDays": 15,
  "aesPwd": "example"
}

2. 使用工具清理JSON

推荐工具：

VS Code（安装JSON格式化插件）
Notepad++（显示所有字符）
在线JSON校验工具（如 JSONLint）

示例：

// 格式化前（可能含隐藏字符）
{ "channelId": 100000132 }

// 格式化后（标准JSON）
{
  "channelId": 100000132
}

3. 检查请求原始数据

使用 hexdump 或 xxd 查看请求体中的隐藏字符：

echo '{
  "channelId": 100000132
}' | hexdump -C

输出示例：

00000000  7b 0a c2 a0 22 63 68 61  6e 6e 65 6c 49 64 22 3a  |{..."channelId":|

其中 c2 a0 是   的UTF-8编码，说明存在非法字符。

4. 代码层面过滤非法字符

如果问题持续，可以在Java后端对输入进行清理：

import org.springframework.util.StringUtils;

public class SpiderParam {
    private String enName;

    // 移除所有空白字符
    public void setEnName(String enName) {
        this.enName = enName.replaceAll("\\u00A0", ""); // 移除 &nbsp;
    }
}

深入排查：Spring Boot的JSON解析机制

1. Jackson库的工作流程

Spring Boot默认使用 Jackson 解析JSON，流程如下：

客户端发送JSON请求。
DispatcherServlet 接收请求，交给 HttpMessageConverter 处理。
MappingJackson2HttpMessageConverter 使用 ObjectMapper 解析JSON。
如果解析失败，抛出 JsonParseException，返回400错误。

2. 关键日志配置

在 application.yml 中启用详细日志：

logging:
  level:
    org.springframework.web: DEBUG
    org.springframework.validation: DEBUG

server:
  error:
    include-binding-errors: always
    include-message: always

日志会显示具体的解析错误，例如：

JSON parse error: Unexpected character (' ' (code 160))

3. 使用 @Valid 进行参数校验

在Controller中添加 @Valid 注解，捕获校验错误：

@PostMapping("/spider")
public ResponseEntity<String> spider(@Valid @RequestBody SpiderParam spiderParam) {
    return ResponseEntity.ok("Success");
}

全局异常处理：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<String> handleValidationException(MethodArgumentNotValidException ex) {
        String errorMsg = ex.getBindingResult().getFieldErrors().stream()
                .map(error -> error.getField() + ": " + error.getDefaultMessage())
                .collect(Collectors.joining(", "));
        return ResponseEntity.badRequest().body(errorMsg);
    }
}

错误示例：

channelId: must not be null, platformAccount: must not be blank

最佳实践

1. 如何避免JSON解析错误？

问题	解决方案
非法空白字符	手动输入JSON，或用工具清理
字段名不匹配	使用 `@JsonProperty("en_name")`
缺少必填字段	添加 `@NotNull` 注解
类型不匹配	确保JSON和Java类型一致

2. 推荐工具

工具	用途
Postman	测试API，生成标准JSON
VS Code	格式化JSON，显示隐藏字符
curl	快速测试请求

总结

本文通过一个实际案例，详细分析了Spring Boot中JSON解析错误的排查方法：

问题定位：日志分析 + 错误信息解读。
解决方案：手动输入JSON、工具清理、代码过滤。
深入机制：Jackson解析流程 + 参数校验。
最佳实践：避免非法字符、使用校验注解。

关键点：

始终手动输入JSON，避免复制粘贴。
启用详细日志，快速定位问题。
使用 @Valid 进行校验，提高代码健壮性。

到此这篇关于SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法的文章就介绍到这了,更多相关SpringBoot JSON解析错误内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Spring Cloud Admin健康检查邮件、钉钉群通知的实现
这篇文章主要介绍了Spring Cloud Admin健康检查邮件、钉钉群通知的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-08-08
IDEA中java: 找不到符号符号: 变量log
这篇文章主要介绍了使用@Slf4j注解时出现log变量找不到符号问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-06-06
Eureka源码阅读之环境搭建及工程结构
这篇文章主要为大家介绍了Eureka源码阅读之环境搭建的工程结构及调试需知详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪<BR>
2022-10-10
使用SpringBoot整合Jpa的过程详解
SpringBoot是一种快速开发框架,它简化了Java应用程序的开发过程,而Jpa是Java持久化规范的一种实现,将SpringBoot与Jpa整合可以更加方便地进行数据库操作,提高开发效率,本文将介绍如何使用Spring Boot整合Jpa,帮助读者快速上手并应用于实际项目中
2023-12-12
详解Java中布隆过滤器(Bloom Filter)原理及其使用场景
布隆过滤器是1970年由布隆提出的，它实际上是一个很长的二进制向量和一系列随机映射函数，它的作用是检索一个元素是否存在我们的集合之中，本文给大家详细的讲解一下布隆过滤器，感兴趣的同学可以参考阅读
2023-05-05
关于logBack配置日志文件及编码配置的问题
这篇文章主要介绍了logBack配置日志文件及编码配置的问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-07-07
Json字符串与Object、List、Map的互转工具类
今天小编就为大家分享一篇关于Json字符串与Object、List、Map的互转工具类，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2018-12-12
java读取resources文件详解及实现代码
这篇文章主要介绍了java读取resources文件详解及实现代码的相关资料,在开发项目的时候经常会遇到读取文件夹里面的内容，需要的朋友可以参考下
2017-07-07
Mybatis返回单个实体或者返回List的实现
这篇文章主要介绍了Mybatis返回单个实体或者返回List的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-07-07
Spring sentinel哨兵模式相关原理解析
这篇文章主要介绍了Spring sentinel哨兵模式相关原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-11-11