Hibernate如何为List<String>类型字段配置字符串长度校验？

针对你遇到的「给List中每个元素配置长度限制，又不想用封装类」的问题，我分享几个更优雅的方案，都是基于Java校验规范（JSR-380）实现的，不用额外创建冗余的包装类：

方案1：用@ElementCollection + @Pattern快速实现 #

如果你用的是Spring Boot（默认集成Hibernate Validator），可以直接结合@ElementCollection和@Pattern注解，对集合中的每个String元素做长度校验：

import javax.validation.constraints.Pattern;
import javax.validation.Valid;
import javax.persistence.ElementCollection;
import java.util.List;

// 实体类中的字段定义
@Valid
@ElementCollection
@Pattern(
    regexp = ".{1,40}", 
    message = "每条地址行长度必须在1到40字符之间"
)
private List<String> addressLines;

• 正则表达式.{1,40}表示匹配1到40个任意字符（如果允许空字符串，改成.{0,40}即可）；
• @Valid会触发对集合内元素的校验，@ElementCollection告诉校验框架要处理集合中的每个元素；
• 优点：零自定义代码，实现简单；缺点：如果需要更复杂的校验逻辑（比如同时校验字符类型），正则表达式会变得臃肿。

方案2：自定义约束注解（更灵活的扩展） #

如果需要更灵活的校验逻辑（比如动态配置最小/最大长度、添加内容格式校验），可以自定义一个专属的约束注解：

第一步：创建自定义注解 #

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

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = AddressLinesValidator.class)
public @interface ValidAddressLines {
    // 默认错误提示
    String message() default "每条地址行长度必须在1到40字符之间";
    
    // 校验分组（可选）
    Class<?>[] groups() default {};
    
    // 负载（可选）
    Class<? extends Payload>[] payload() default {};
    
    // 可配置的最小长度
    int min() default 1;
    
    // 可配置的最大长度
    int max() default 40;
}

第二步：实现校验器 #

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

public class AddressLinesValidator implements ConstraintValidator<ValidAddressLines, List<String>> {
    private int minLength;
    private int maxLength;

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

    @Override
    public boolean isValid(List<String> addressLines, ConstraintValidatorContext context) {
        // 允许null的话直接返回true，否则改成false
        if (addressLines == null) {
            return true;
        }
        
        for (String line : addressLines) {
            if (line == null || line.length() < minLength || line.length() > maxLength) {
                // 禁用默认错误信息，自定义更友好的提示
                context.disableDefaultConstraintViolation();
                context.buildConstraintViolationWithTemplate(
                        String.format("地址行「%s」长度不符合要求，需在%d-%d字符之间", line, minLength, maxLength)
                ).addConstraintViolation();
                return false;
            }
        }
        return true;
    }
}

第三步：在实体类中使用 #

@ValidAddressLines(max = 40) // 可以自定义min和max参数
private List<String> addressLines;

• 优点：高度可定制，能扩展更多校验规则（比如地址行不能包含特殊字符），错误提示更友好；
• 缺点：需要写少量自定义代码，但复用性极强。

为什么不推荐封装类的临时方案？ #

你提到的封装类方法虽然可行，但确实会增加不必要的类层级，而且如果多个地方需要类似的List校验，会产生大量重复代码。上面的两种方案都能直接在List字段上实现校验，代码更简洁、维护成本更低。

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