REST API 出现 Integer Overflow 错误的最优处理方案咨询

处理REST API整数溢出无需对每个Integer参数逐一做手工校验，最优方案是在请求的全链路分层做统一拦截处理，具体实现方案如下：

1. 反序列化层全局拦截（优先级最高，推荐首选） #

Integer溢出绝大多数发生在JSON字符串反序列化为Java对象的阶段，早于参数进入Controller方法的时间点，因此直接在序列化框架层做统一校验即可覆盖所有接口的Integer参数：

• 以SpringBoot体系的Jackson序列化框架为例，自定义Integer类型反序列化器，数值超出Integer范围时直接抛出规范的参数异常，示例代码如下：

// 自定义Integer反序列化器
public class SafeIntegerDeserializer extends StdDeserializer<Integer> {
    public SafeIntegerDeserializer() {
        super(Integer.class);
    }

    @Override
    public Integer deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {
        long inputValue = jsonParser.getLongValue();
        if (inputValue > Integer.MAX_VALUE || inputValue < Integer.MIN_VALUE) {
            throw new IllegalArgumentException("参数数值超出整数允许范围");
        }
        return (int) inputValue;
    }
}

• 将自定义反序列化器注册到全局Jackson配置中，即可对所有接口的Integer类型参数生效，无需额外修改业务代码。

2. 全局异常层统一封装响应 #

反序列化阶段抛出的异常不需要在每个Controller单独捕获，通过全局异常处理器统一拦截数值相关异常，返回符合业务规范的错误响应即可：

@RestControllerAdvice
public class GlobalParamExceptionHandler {

    @ExceptionHandler({JsonParseException.class, NumberFormatException.class, IllegalArgumentException.class})
    public ApiResponse handleNumberError(Exception e) {
        // 可根据异常栈信息判断是否为整数溢出，返回对应错误提示
        return ApiResponse.error(400, "请求参数非法：存在超出范围的数值");
    }
}

3. 特殊业务范围校验用注解实现 #

如果部分参数有自定义的业务范围限制（比如isForcedUpdate只能是0/1，recordCount不能超过1000），直接在DTO字段上加JSR-380校验注解即可，不需要手写判断逻辑：

public class BusinessRequestDTO {
    @Min(0)
    @Max(1)
    private Integer isForcedUpdate;

    @Min(1)
    @Max(1000)
    private Integer recordCount;

    // 省略getter/setter
}

在Controller对应接口的DTO参数前加@Valid注解即可自动触发校验，校验不通过的错误也可通过全局异常处理器统一处理。

内容的提问来源于stack exchange，提问作者beingumang