如何在Java中限制方法参数为非负整数？

你用的这些Bean Validation注解（@Min、@Positive）本身规则是对的，但默认不会自动触发校验，得配合特定机制或者手动校验才能生效。下面给几种靠谱的实现方式：

1. 手动参数校验（无框架依赖，最直接） #

直接在方法开头加判断逻辑，不符合要求就抛异常，简单高效：

public List<UserEntity> findUsersCreatedInTheLast(Integer minutes) {
    if (minutes == null) {
        throw new IllegalArgumentException("minutes 不能为 null");
    }
    if (minutes < 0) {
        throw new IllegalArgumentException("minutes 不能为负数");
    }
    // 后续业务逻辑代码
}

如果需要限制为正整数（不允许0），把判断条件改成minutes <= 0即可。

2. Spring环境下激活Bean Validation校验 #

如果你的项目基于Spring框架，仅在方法参数上加注解不够，还需要两步配置：

• 在类上添加@Validated注解，告诉Spring开启方法级参数校验
• 确保项目引入了Bean Validation的依赖（比如hibernate-validator）

修改后的代码示例：

import org.springframework.validation.annotation.Validated;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;

@Validated // 必须添加在类上，开启方法校验
public class UserService {

    public List<UserEntity> findUsersCreatedInTheLast(@NotNull @Min(0) Integer minutes) {
        // 后续业务逻辑代码
    }
}

当传入负数或null时，Spring会自动抛出ConstraintViolationException异常。如果要限制为正整数，把@Min(0)换成@Positive（注意@Positive不允许0，@PositiveOrZero允许0）。

3. 借助工具类简化校验 #

用Guava或Apache Commons Lang的工具类减少重复判断代码：
比如使用Guava的Ints工具类：

import com.google.common.primitives.Ints;

public List<UserEntity> findUsersCreatedInTheLast(Integer minutes) {
    // 校验正整数
    if (minutes == null || !Ints.isPositive(minutes)) {
        throw new IllegalArgumentException("minutes 必须为正整数");
    }
    // 校验非负整数的话，用这个判断：minutes == null || minutes < 0
    // 后续业务逻辑代码
}

为什么之前的注解无效？ #

@Valid是用来校验嵌套对象的，加在单个参数上没有作用；@NonNull、@Min这些属于Bean Validation规范，需要校验器（比如Hibernate Validator）执行校验逻辑，默认不会自动触发方法参数的校验，必须通过@Validated（Spring环境）或者手动调用Validator接口来触发校验。

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