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

本文主要是介绍SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《SpringBoot排查和解决JSON解析错误(400BadRequest)的方法》在开发SpringBootRESTfulAPI时,客户端与服务端的数据交互通常使用JSON格式,然而,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文档或富文本编辑器复制的,导致包含隐藏字符。
解决方php法:手动重新输入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(Stringjs enName) {
        this.enName = enName.replaceAll("\\u00A0", ""); // 移除  
    }
}

深入排查: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.getBindingReTtisRsult().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解析错误China编程

问题解决方案
非法空白字符手动输入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解析错误内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1155037

相关文章

Java堆转储文件之1.6G大文件处理完整指南

《Java堆转储文件之1.6G大文件处理完整指南》堆转储文件是优化、分析内存消耗的重要工具,:本文主要介绍Java堆转储文件之1.6G大文件处理的相关资料,文中通过代码介绍的非常详细,需要的朋友可... 目录前言文件为什么这么大?如何处理这个文件?分析文件内容(推荐)删除文件(如果不需要)查看错误来源如何避

SpringBoot整合Dubbo+ZK注册失败的坑及解决

《SpringBoot整合Dubbo+ZK注册失败的坑及解决》使用Dubbo框架时,需在公共pom添加依赖,启动类加@EnableDubbo,实现类用@DubboService替代@Service,配... 目录1.先看下公共的pom(maven创建的pom工程)2.启动类上加@EnableDubbo3.实

SpringBoot整合(ES)ElasticSearch7.8实践

《SpringBoot整合(ES)ElasticSearch7.8实践》本文详细介绍了SpringBoot整合ElasticSearch7.8的教程,涵盖依赖添加、客户端初始化、索引创建与获取、批量插... 目录SpringBoot整合ElasticSearch7.8添加依赖初始化创建SpringBoot项

JAVA覆盖和重写的区别及说明

《JAVA覆盖和重写的区别及说明》非静态方法的覆盖即重写,具有多态性;静态方法无法被覆盖,但可被重写(仅通过类名调用),二者区别在于绑定时机与引用类型关联性... 目录Java覆盖和重写的区别经常听到两种话认真读完上面两份代码JAVA覆盖和重写的区别经常听到两种话1.覆盖=重写。2.静态方法可andro

Nginx安全防护的多种方法

《Nginx安全防护的多种方法》在生产环境中,需要隐藏Nginx的版本号,以避免泄漏Nginx的版本,使攻击者不能针对特定版本进行攻击,下面就来介绍一下Nginx安全防护的方法,感兴趣的可以了解一下... 目录核心安全配置1.编译安装 Nginx2.隐藏版本号3.限制危险请求方法4.请求限制(CC攻击防御)

nginx中端口无权限的问题解决

《nginx中端口无权限的问题解决》当Nginx日志报错bind()to80failed(13:Permissiondenied)时,这通常是由于权限不足导致Nginx无法绑定到80端口,下面就来... 目录一、问题原因分析二、解决方案1. 以 root 权限运行 Nginx(不推荐)2. 为 Nginx

SpringBoot中六种批量更新Mysql的方式效率对比分析

《SpringBoot中六种批量更新Mysql的方式效率对比分析》文章比较了MySQL大数据量批量更新的多种方法,指出REPLACEINTO和ONDUPLICATEKEY效率最高但存在数据风险,MyB... 目录效率比较测试结构数据库初始化测试数据批量修改方案第一种 for第二种 case when第三种

python生成随机唯一id的几种实现方法

《python生成随机唯一id的几种实现方法》在Python中生成随机唯一ID有多种方法,根据不同的需求场景可以选择最适合的方案,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习... 目录方法 1:使用 UUID 模块(推荐)方法 2:使用 Secrets 模块(安全敏感场景)方法

解决1093 - You can‘t specify target table报错问题及原因分析

《解决1093-Youcan‘tspecifytargettable报错问题及原因分析》MySQL1093错误因UPDATE/DELETE语句的FROM子句直接引用目标表或嵌套子查询导致,... 目录报js错原因分析具体原因解决办法方法一:使用临时表方法二:使用JOIN方法三:使用EXISTS示例总结报错原

Java docx4j高效处理Word文档的实战指南

《Javadocx4j高效处理Word文档的实战指南》对于需要在Java应用程序中生成、修改或处理Word文档的开发者来说,docx4j是一个强大而专业的选择,下面我们就来看看docx4j的具体使用... 目录引言一、环境准备与基础配置1.1 Maven依赖配置1.2 初始化测试类二、增强版文档操作示例2.