一、問題背景：為什么我的接口突然報錯了？

假設你正在開發(fā)一個 Spring Boot 接口，接收類似這樣的 JSON 請求：

{
  "size": 111111111111111111111
}

然后突然收到用戶的反饋：請求報錯啦！查看日志，發(fā)現(xiàn)一個刺眼的異常：

JSON parse error: Numeric value (111111111111111111111) out of range of int

翻譯成“人話”：前端傳的 size 值太大，后端用 int 類型接收時，超出了 int 的范圍（-2147483648 ~ 2147483647），導致 JSON 解析失?。?/p>

二、為什么會發(fā)生這個錯誤？

1. Java 數(shù)據(jù)類型的“容量”限制

• int 類型最大只能表示 2147483647。
• 當 JSON 中的數(shù)值超過這個范圍時，int 裝不下，就會觸發(fā)溢出錯誤。

2. 誰在幕后“搞事情”？

• Jackson 庫：Spring Boot 默認使用 Jackson 解析 JSON。
  當字段類型是 int 或 Integer，但 JSON 數(shù)值過大時，Jackson 會直接拋異常！

三、解決方案：三步搞定

第一步：修改字段類型（治本）

直接將 size 的字段類型改為 Long，一步到位解決問題！

public class EsSearchResultRequest {
    private Long size;  // ? 改為 Long 類型
    // 其他字段...
}

為什么有效？

• Long 的范圍是 -9223372036854775808 ~ 9223372036854775807，足夠容納超大數(shù)值。

第二步：全局異常處理（優(yōu)雅提示）

在 GlobalExceptionHandler 中捕獲異常，返回友好提示：

@ExceptionHandler(HttpMessageNotReadableException.class)
public ResponseEntity<String> handleHttpMessageNotReadable(HttpMessageNotReadableException ex) {
    String errorMessage = "請求參數(shù)格式錯誤，請檢查數(shù)值范圍";
    // 提取具體錯誤原因（可選）
    if (ex.getCause() instanceof JsonMappingException) {
        errorMessage = ex.getCause().getMessage(); 
    }
    return ResponseEntity.badRequest().body(errorMessage);
}

效果示例：前端收到提示：

Numeric value (111111111111111111111) out of range of int

第三步：數(shù)據(jù)校驗（防御性編程）

如果業(yè)務要求 size 必須是較小的數(shù)值，可添加校驗邏輯：

public class EsSearchResultRequest {
    @Min(value = 1, message = "size 最小為 1")
    @Max(value = 1000, message = "size 最大為 1000")
    private Long size;
    // 其他字段...
}

校驗失敗時提示：

size 最大為 1000

四、擴展知識：為什么不用 Integer？

經驗法則：

• 不確定數(shù)值大小時，優(yōu)先用 Long。
• 永遠不要用 int 存儲可能超大的值！

五、常見問題 FAQ

1. 前端傳的是字符串，也會報錯嗎？

• 不會！如果 JSON 中 size 是字符串 "111111111111111111111"，需在后端用 String 類型接收，再手動轉換。

2. 數(shù)據(jù)庫字段類型需要改嗎？

• 如果 size 要存到數(shù)據(jù)庫（如 MySQL），記得同步修改為 BIGINT，否則會插入失??！

3. 為什么異常處理要捕獲 HttpMessageNotReadableException？

• 這是 Spring 在解析請求體失敗時拋出的“總異常”，涵蓋所有 JSON 解析錯誤（如類型不匹配、格式錯誤等）。

六、總結：避坑指南

• 設計階段：根據(jù)業(yè)務場景選擇合適的數(shù)據(jù)類型。
  • 不確定時，無腦用 Long！
• 編碼階段：
  • 添加數(shù)據(jù)校驗（如 @Min、@Max）。
  • 全局異常處理，返回友好提示。
• 協(xié)作階段：
  • 告知前端參數(shù)范圍和格式要求。
  • 更新接口文檔，明確 size 的類型和限制。

到此這篇關于Spring Boot中JSON數(shù)值溢出問題從報錯到優(yōu)雅解決辦法的文章就介紹到這了,更多相關SpringBoot JSON數(shù)值溢出問題內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論