Spring Boot控制器层如何用注解限制List最大长度？@Max无效

@Max注解仅用于限制**数值类型（如Integer、Long）**的最大值，对集合的大小限制完全不生效，这是你当前问题的核心原因。以下是两种可行的解决方法：

方法一：使用Hibernate Validator的@Size注解（推荐） #

Hibernate Validator作为JSR-380（Bean Validation）的实现，提供了@Size注解，专门用于限制集合、数组、字符串的长度/大小，直接使用即可满足需求：

import javax.validation.constraints.Size;

// 限制List最大长度为10，自定义提示信息
@Size(max = 10, message = "IP范围列表最多只能包含10个元素")
private List<String> ipRange;

注意：需确保项目中引入了Hibernate Validator依赖，Maven依赖示例：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.2.5.Final</version>
</dependency>

方法二：自定义校验注解 #

如果需要更灵活的校验逻辑（比如同时限制最小/最大长度、自定义校验规则），可以自定义注解和校验器：

1. 定义自定义注解@ListSize #

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

@Documented
@Constraint(validatedBy = ListSizeValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface ListSize {
    String message() default "List大小超出限制";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    int max() default Integer.MAX_VALUE;
    int min() default 0;
}

2. 实现校验器ListSizeValidator #

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.List;

public class ListSizeValidator implements ConstraintValidator<ListSize, List<?>> {
    private int max;
    private int min;

    @Override
    public void initialize(ListSize constraintAnnotation) {
        this.max = constraintAnnotation.max();
        this.min = constraintAnnotation.min();
    }

    @Override
    public boolean isValid(List<?> list, ConstraintValidatorContext context) {
        // 允许null的话返回true，不允许则返回false
        if (list == null) {
            return true;
        }
        return list.size() >= min && list.size() <= max;
    }
}

3. 使用自定义注解 #

@ListSize(max = 10, message = "IP范围列表最多只能包含10个元素")
private List<String> ipRange;

关键注意事项 #

无论使用哪种方式，都需要确保Bean的校验逻辑被触发：

• 在Controller方法的参数上添加@Valid或@Validated注解，触发Spring的校验机制；
• 如果是非Spring环境，需要手动通过Validator实例执行校验。

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