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", ""); // 移除 &nbsp;
    }
}

深入排查：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類型一致