SpringBoot排查和解決JSON解析錯誤(400 Bad Request)的方法
更新時間：2025年06月12日 16:37:32 作者：碼農阿豪@新空間
在開發(fā)Spring Boot RESTful API時,客戶端與服務端的數據交互通常使用JSON格式,然而,JSON解析錯誤（如400 Bad Request）是常見的開發(fā)問題之一,本文將通過一個實際案例,詳細分析如何排查和解決JSON解析錯誤,并總結最佳實踐,需要的朋友可以參考下
問題背景
1. 問題描述
開發(fā)者在調用本地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. 代碼層面過濾非法字符
如果問題持續(xù)，可以在Java后端對輸入進行清理：
import org.springframework.util.StringUtils;
public class SpiderParam {
private String enName;
// 移除所有空白字符
public void setEnName(String enName) {
this.enName = enName.replaceAll("\\u00A0", ""); // 移除
}
}
深入排查：Spring Boot的JSON解析機制
1. Jackson庫的工作流程
Spring Boot默認使用 Jackson 解析JSON，流程如下：
- 客戶端發(fā)送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解析錯誤內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要介紹了Java Jmeter全局變量設置過程圖解,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-05-05
mybatis實現表與對象的關聯關系_動力節(jié)點Java學院整理
這篇文章主要介紹了mybatis實現表與對象的關聯關系_動力節(jié)點Java學院整理,需要的朋友可以參考下2017-09-09
本篇文章主要介紹了java中利用Dom4j解析和生成XML文檔，dom4j是一套非常優(yōu)秀的Java開源api，主要用于讀寫xml文檔，具有性能優(yōu)異、功能強大、和非常方便使用的特點。有興趣的可以了解一下。2016-11-11
淺談Spring Boot、MyBatis、MyBatis-Plus 依賴版本對應關系
本文主要介紹了SpringBoot、MyBatis和MyBatis-Plus的依賴版本對應關系,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2024-11-11
這篇文章主要介紹了SpringIOC控制反轉的原理詳解,本來管理業(yè)務對象(bean)的操作是由我們程序員去做的，但是有了?Spring?核心容器后，這些?Bean?對象的創(chuàng)建和管理交給我們Spring容器去做了，也就是控制權由程序員變成了容器,需要的朋友可以參考下2023-08-08
本文主要介紹了SpringBoot集成百度AI實現人臉識別的項目實踐，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-05-05
在日常編碼過程中常常涉及到事務,在前兩天看到一篇文章提到了Spring事務,那么在此總結下在Spring環(huán)境下事務失效的幾種原因2021-09-09
java?面向對象代碼塊及不同位置對屬性賦值的執(zhí)行順序
這篇文章主要介紹了java面向對象代碼塊及不同位置對屬性賦值的執(zhí)行順序，文章圍繞主題展開詳細的內容介紹，具有一定的參考價值，需要的小伙伴可以參考一下2022-09-09
這篇文章主要介紹了java中BASE64加密/解密的相關資料,并詳細展示了如何在Java中使用內置的Base64類進行編碼和解碼,文章還涵蓋不同類型的Base64編碼及其應用場景,需要的朋友可以參考下2025-05-05
本文詳細講解了Mybatis是如何防止sql注入的，對大家的學習或工作具有一定的參考借鑒價值。需要的朋友可以收藏下，方便下次瀏覽觀看2021-12-12