Spring Boot 项目中判断集合（List、Set、Map）不能为空且不为 null的注解使用

在 Spring Boot (结合 Bean Validation / Hibernate Validator) 中，判断集合（List、Set、Map）不能为空且不为 null，最常用且语义最准确的注解是 @NotEmpty。

推荐写法

import jakarta.validation.constraints.NotEmpty; // Spring Boot 3.x
// import javax.validation.constraints.NotEmpty; // Spring Boot 2.x 及以下

public class OrderRequest {

    @NotEmpty(message = "订单项ID集合不能为空")
    private List<Long> orderItemIds;

    // getter and setter...
}

为什么选 @NotEmpty？（与其他注解的对比）

注意事项

1. 依赖引入：
   从 Spring Boot 2.3 开始，Validation 启动器被独立出来了，如果你的项目中注解无法导入，需要手动在 pom.xml 中添加：

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-validation</artifactId>
   </dependency>
   

2. 触发验证：
   注解加上后，必须在 Controller 层的方法参数前加上 @Valid 或 @Validated 才会生效：

   @PostMapping("/create")
   public Result createOrder(@RequestBody @Valid OrderRequest request) {
       // ...
   }
   

总结：请直接使用 @NotEmpty。