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

相关文章

Spring Security 单点登录与自动登录机制的实现原理

《SpringSecurity单点登录与自动登录机制的实现原理》本文探讨SpringSecurity实现单点登录(SSO)与自动登录机制,涵盖JWT跨系统认证、RememberMe持久化Token... 目录一、核心概念解析1.1 单点登录(SSO)1.2 自动登录(Remember Me)二、代码分析三、

Linux系统中查询JDK安装目录的几种常用方法

《Linux系统中查询JDK安装目录的几种常用方法》:本文主要介绍Linux系统中查询JDK安装目录的几种常用方法,方法分别是通过update-alternatives、Java命令、环境变量及目... 目录方法 1:通过update-alternatives查询(推荐)方法 2:检查所有已安装的 JDK方

SQL Server安装时候没有中文选项的解决方法

《SQLServer安装时候没有中文选项的解决方法》用户安装SQLServer时界面全英文,无中文选项,通过修改安装设置中的国家或地区为中文中国,重启安装程序后界面恢复中文,解决了问题,对SQLSe... 你是不是在安装SQL Server时候发现安装界面和别人不同,并且无论如何都没有中文选项?这个问题也

springboot自定义注解RateLimiter限流注解技术文档详解

《springboot自定义注解RateLimiter限流注解技术文档详解》文章介绍了限流技术的概念、作用及实现方式,通过SpringAOP拦截方法、缓存存储计数器,结合注解、枚举、异常类等核心组件,... 目录什么是限流系统架构核心组件详解1. 限流注解 (@RateLimiter)2. 限流类型枚举 (

Java Thread中join方法使用举例详解

《JavaThread中join方法使用举例详解》JavaThread中join()方法主要是让调用改方法的thread完成run方法里面的东西后,在执行join()方法后面的代码,这篇文章主要介绍... 目录前言1.join()方法的定义和作用2.join()方法的三个重载版本3.join()方法的工作原

MySQL CTE (Common Table Expressions)示例全解析

《MySQLCTE(CommonTableExpressions)示例全解析》MySQL8.0引入CTE,支持递归查询,可创建临时命名结果集,提升复杂查询的可读性与维护性,适用于层次结构数据处... 目录基本语法CTE 主要特点非递归 CTE简单 CTE 示例多 CTE 示例递归 CTE基本递归 CTE 结

Spring AI使用tool Calling和MCP的示例详解

《SpringAI使用toolCalling和MCP的示例详解》SpringAI1.0.0.M6引入ToolCalling与MCP协议,提升AI与工具交互的扩展性与标准化,支持信息检索、行动执行等... 目录深入探索 Spring AI聊天接口示例Function CallingMCPSTDIOSSE结束语

Java获取当前时间String类型和Date类型方式

《Java获取当前时间String类型和Date类型方式》:本文主要介绍Java获取当前时间String类型和Date类型方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录Java获取当前时间String和Date类型String类型和Date类型输出结果总结Java获取

Spring Boot Actuator应用监控与管理的详细步骤

《SpringBootActuator应用监控与管理的详细步骤》SpringBootActuator是SpringBoot的监控工具,提供健康检查、性能指标、日志管理等核心功能,支持自定义和扩展端... 目录一、 Spring Boot Actuator 概述二、 集成 Spring Boot Actuat

OpenCV在Java中的完整集成指南分享

《OpenCV在Java中的完整集成指南分享》本文详解了在Java中集成OpenCV的方法,涵盖jar包导入、dll配置、JNI路径设置及跨平台兼容性处理,提供了图像处理、特征检测、实时视频分析等应用... 目录1. OpenCV简介与应用领域1.1 OpenCV的诞生与发展1.2 OpenCV的应用领域2