本文主要是介绍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)的方法的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
