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", ""); // 移除 &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.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)的方法的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！