Java中Integer类型参数非数值输入的校验方案咨询

问题根源 #

Spring MVC处理请求时，会优先执行参数类型转换，再进行Bean Validation注解（@NotNull、@Digits等）的校验。当传入非数值字符串到Integer字段时，转换阶段直接抛出NumberFormatException，导致后续注解校验完全不执行。而@Pattern注解仅适用于String类型，直接标注在Integer字段上会引发类型不匹配的500错误。

可行解决方案 #

方案1：先以String接收参数，校验后转Integer #

将字段改为String类型，用@Pattern校验格式，再在业务逻辑或通过转换器转为Integer：

@NotNull(message = "Year cannot be null")
@Pattern(regexp = "^\\d{4}$", message = "Provide valid Year in the format YYYY")
private String yearStr;

// 可选：在实体类中添加转换逻辑
public Integer getYear() {
    return yearStr != null ? Integer.parseInt(yearStr) : null;
}

之后再对转换后的Integer值做范围校验（比如1900最小值限制），可以在业务层处理，或者通过自定义校验注解实现。

方案2：自定义类型转换器+全局异常处理 #

通过自定义String到Integer的转换器，在转换失败时抛出友好的校验异常，同时整合格式与范围校验逻辑：

1. 实现自定义转换器：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

@Component
public class StringToYearConverter implements Converter<String, Integer> {
    @Override
    public Integer convert(String source) {
        if (source == null || source.isBlank()) {
            return null; // 配合@NotNull校验空值
        }
        if (!source.matches("^\\d{4}$")) {
            throw new IllegalArgumentException("Provide valid Year in the format YYYY");
        }
        Integer year = Integer.parseInt(source);
        if (year < 1900) {
            throw new IllegalArgumentException("Year must be greater than 1900");
        }
        return year;
    }
}

2. 添加全局异常处理器捕获转换异常：

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

@ControllerAdvice
public class GlobalValidationHandler {
    @ExceptionHandler(IllegalArgumentException.class)
    @ResponseBody
    public String handleValidationErrors(IllegalArgumentException e) {
        return e.getMessage();
    }
}

这种方式把格式、范围校验都整合到转换器中，转换成功后无需额外注解，转换失败直接返回友好提示。

方案3：自定义校验注解（适用于复杂场景） #

创建自定义的年份校验注解，同时实现校验器，直接对Integer字段进行完整校验：

1. 定义注解：

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = YearValidator.class)
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidYear {
    String message() default "Invalid year format or value";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    int min() default 1900;
}

2. 实现校验器：

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;

public class YearValidator implements ConstraintValidator<ValidYear, Integer> {
    private int minYear;

    @Override
    public void initialize(ValidYear constraintAnnotation) {
        this.minYear = constraintAnnotation.min();
    }

    @Override
    public boolean isValid(Integer year, ConstraintValidatorContext context) {
        if (year == null) {
            return false; // 配合@NotNull或在注解内处理空值
        }
        String yearStr = year.toString();
        return yearStr.matches("^\\d{4}$") && year >= minYear;
    }
}

3. 使用注解：

@NotNull
@ValidYear(min = 1900, message = "Provide valid Year in the format YYYY and greater than 1900")
private Integer year;

注意：这种方式仍需确保参数能成功转换为Integer，否则还是会先触发NumberFormatException，建议结合方案2的转换器一起使用，或者在全局异常处理器中同时捕获该异常并统一返回提示。

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