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解析错误内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java Jmeter全局变量设置过程图解
这篇文章主要介绍了Java Jmeter全局变量设置过程图解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-05-05
mybatis实现表与对象的关联关系_动力节点Java学院整理
这篇文章主要介绍了mybatis实现表与对象的关联关系_动力节点Java学院整理,需要的朋友可以参考下
2017-09-09
java中利用Dom4j解析和生成XML文档
本篇文章主要介绍了java中利用Dom4j解析和生成XML文档，dom4j是一套非常优秀的Java开源api，主要用于读写xml文档，具有性能优异、功能强大、和非常方便使用的特点。有兴趣的可以了解一下。
2016-11-11
浅谈Spring Boot、MyBatis、MyBatis-Plus 依赖版本对应关系
本文主要介绍了SpringBoot、MyBatis和MyBatis-Plus的依赖版本对应关系,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-11-11
SpringIOC控制反转的原理详解
这篇文章主要介绍了SpringIOC控制反转的原理详解,本来管理业务对象(bean)的操作是由我们程序员去做的，但是有了 Spring 核心容器后，这些 Bean 对象的创建和管理交给我们Spring容器去做了，也就是控制权由程序员变成了容器,需要的朋友可以参考下
2023-08-08
SpringBoot集成百度AI实现人脸识别的项目实践
本文主要介绍了SpringBoot集成百度AI实现人脸识别的项目实践，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-05-05
Java spring事务及事务不生效的原因详解
在日常编码过程中常常涉及到事务,在前两天看到一篇文章提到了Spring事务,那么在此总结下在Spring环境下事务失效的几种原因
2021-09-09
java 面向对象代码块及不同位置对属性赋值的执行顺序
这篇文章主要介绍了java面向对象代码块及不同位置对属性赋值的执行顺序，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的小伙伴可以参考一下
2022-09-09
java中BASE64加密/解密详解(附带源码)
这篇文章主要介绍了java中BASE64加密/解密的相关资料,并详细展示了如何在Java中使用内置的Base64类进行编码和解码,文章还涵盖不同类型的Base64编码及其应用场景,需要的朋友可以参考下
2025-05-05
Mybatis是这样防止sql注入的
本文详细讲解了Mybatis是如何防止sql注入的，对大家的学习或工作具有一定的参考借鉴价值。需要的朋友可以收藏下，方便下次浏览观看
2021-12-12