当前位置：日志文章 > 详细内容

SpringBoot中JSON数值溢出问题的处理方案

2025年08月20日 • Java •

一、问题背景：为什么我的接口突然报错了？假设你正在开发一个 spring boot 接口，接收类似这样的 json 请求：{ "size": 111111111111111111111}然后突然收到

一、问题背景：为什么我的接口突然报错了？

假设你正在开发一个 spring boot 接口，接收类似这样的 json 请求：

{
  "size": 111111111111111111111
}

然后突然收到用户的反馈：请求报错啦！

查看日志，发现一个刺眼的异常：

json parse error: numeric value (111111111111111111111) out of range of int

翻译成“人话”：

前端传的 size 值太大，后端用 int 类型接收时，超出了 int 的范围（-2147483648 ~ 2147483647），导致 json 解析失败！

二、为什么会发生这个错误？

1. java 数据类型的“容量”限制

int 类型最大只能表示 2147483647。
当 json 中的数值超过这个范围时，int 装不下，就会触发溢出错误。

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

jackson 库：spring boot 默认使用 jackson 解析 json。
当字段类型是 int 或 integer，但 json 数值过大时，jackson 会直接抛异常！

三、解决方案：三步搞定

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

直接将 size 的字段类型改为 long，一步到位解决问题！

public class essearchresultrequest {
    private long size;  // ✅ 改为 long 类型
    // 其他字段...
}

为什么有效？

long 的范围是 -9223372036854775808 ~ 9223372036854775807，足够容纳超大数值。

第二步：全局异常处理（优雅提示）

在 globalexceptionhandler 中捕获异常，返回友好提示：

@exceptionhandler(httpmessagenotreadableexception.class)
public responseentity<string> handlehttpmessagenotreadable(httpmessagenotreadableexception ex) {
    string errormessage = "请求参数格式错误，请检查数值范围";
    // 提取具体错误原因（可选）
    if (ex.getcause() instanceof jsonmappingexception) {
        errormessage = ex.getcause().getmessage(); 
    }
    return responseentity.badrequest().body(errormessage);
}

效果示例：

前端收到提示：

numeric value (111111111111111111111) out of range of int

第三步：数据校验（防御性编程）

如果业务要求 size 必须是较小的数值，可添加校验逻辑：

public class essearchresultrequest {
    @min(value = 1, message = "size 最小为 1")
    @max(value = 1000, message = "size 最大为 1000")
    private long size;
    // 其他字段...
}

校验失败时提示：