快捷導(dǎo)航

SpringBoot排查和解決JSON解析錯(cuò)誤(400 Bad Request)的方法

更新時(shí)間：2025年06月12日 16:37:32 作者：碼農(nóng)阿豪@新空間

在開(kāi)發(fā)Spring Boot RESTful API時(shí),客戶(hù)端與服務(wù)端的數(shù)據(jù)交互通常使用JSON格式,然而,JSON解析錯(cuò)誤（如400 Bad Request）是常見(jiàn)的開(kāi)發(fā)問(wèn)題之一,本文將通過(guò)一個(gè)實(shí)際案例,詳細(xì)分析如何排查和解決JSON解析錯(cuò)誤,并總結(jié)最佳實(shí)踐,需要的朋友可以參考下

問(wèn)題背景

1. 問(wèn)題描述

開(kāi)發(fā)者在調(diào)用本地Spring Boot接口時(shí)，遇到400 Bad Request錯(cuò)誤：

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"
}'

返回錯(cuò)誤：

{
    "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. 錯(cuò)誤分析

錯(cuò)誤信息表明：

JSON解析失敗，原因是存在非法字符 ' ' (code 160)（即HTML的空格  ）。
根本問(wèn)題：JSON請(qǐng)求體中混入了不可見(jiàn)的特殊字符，導(dǎo)致Jackson解析失敗。

解決方案

1. 手動(dòng)重新輸入JSON

問(wèn)題原因：JSON可能是從網(wǎng)頁(yè)、Word文檔或富文本編輯器復(fù)制的，導(dǎo)致包含隱藏字符。
解決方法：手動(dòng)重新輸入JSON，避免復(fù)制粘貼：

{
  "channelId": 100000132,
  "platformAccount": "yien",
  "platformPwd": "123456",
  "enName": "jinYiMu",
  "grabDays": 15,
  "aesPwd": "example"
}

2. 使用工具清理JSON

推薦工具：

VS Code（安裝JSON格式化插件）
Notepad++（顯示所有字符）
在線JSON校驗(yàn)工具（如 JSONLint）

示例：

// 格式化前（可能含隱藏字符）
{ "channelId": 100000132 }

// 格式化后（標(biāo)準(zhǔn)JSON）
{
  "channelId": 100000132
}

3. 檢查請(qǐng)求原始數(shù)據(jù)

使用 hexdump 或 xxd 查看請(qǐng)求體中的隱藏字符：

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編碼，說(shuō)明存在非法字符。

4. 代碼層面過(guò)濾非法字符

如果問(wèn)題持續(xù)，可以在Java后端對(duì)輸入進(jìn)行清理：

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解析機(jī)制

1. Jackson庫(kù)的工作流程

Spring Boot默認(rèn)使用 Jackson 解析JSON，流程如下：

客戶(hù)端發(fā)送JSON請(qǐng)求。
DispatcherServlet 接收請(qǐng)求，交給 HttpMessageConverter 處理。
MappingJackson2HttpMessageConverter 使用 ObjectMapper 解析JSON。
如果解析失敗，拋出 JsonParseException，返回400錯(cuò)誤。

2. 關(guān)鍵日志配置

在 application.yml 中啟用詳細(xì)日志：

logging:
  level:
    org.springframework.web: DEBUG
    org.springframework.validation: DEBUG

server:
  error:
    include-binding-errors: always
    include-message: always

日志會(huì)顯示具體的解析錯(cuò)誤，例如：

JSON parse error: Unexpected character (' ' (code 160))

3. 使用 @Valid 進(jìn)行參數(shù)校驗(yàn)

在Controller中添加 @Valid 注解，捕獲校驗(yàn)錯(cuò)誤：

@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);
    }
}

錯(cuò)誤示例：

channelId: must not be null, platformAccount: must not be blank

最佳實(shí)踐

1. 如何避免JSON解析錯(cuò)誤？

問(wèn)題	解決方案
非法空白字符	手動(dòng)輸入JSON，或用工具清理
字段名不匹配	使用 `@JsonProperty("en_name")`
缺少必填字段	添加 `@NotNull` 注解
類(lèi)型不匹配	確保JSON和Java類(lèi)型一致

2. 推薦工具

工具	用途
Postman	測(cè)試API，生成標(biāo)準(zhǔn)JSON
VS Code	格式化JSON，顯示隱藏字符
curl	快速測(cè)試請(qǐng)求

總結(jié)

本文通過(guò)一個(gè)實(shí)際案例，詳細(xì)分析了Spring Boot中JSON解析錯(cuò)誤的排查方法：

問(wèn)題定位：日志分析 + 錯(cuò)誤信息解讀。
解決方案：手動(dòng)輸入JSON、工具清理、代碼過(guò)濾。
深入機(jī)制：Jackson解析流程 + 參數(shù)校驗(yàn)。
最佳實(shí)踐：避免非法字符、使用校驗(yàn)注解。

關(guān)鍵點(diǎn)：

始終手動(dòng)輸入JSON，避免復(fù)制粘貼。
啟用詳細(xì)日志，快速定位問(wèn)題。
使用 @Valid 進(jìn)行校驗(yàn)，提高代碼健壯性。

到此這篇關(guān)于SpringBoot排查和解決JSON解析錯(cuò)誤(400 Bad Request)的方法的文章就介紹到這了,更多相關(guān)SpringBoot JSON解析錯(cuò)誤內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: