在 Spring Web 中，可通过将 @RequestParam(required = false) 设为 false，使参数缺失时为 null、参数存在但无值时为空列表，从而精准区分两种语义：null 表示未启用过滤，empty list 表示启用了“空值过滤”，二者需返回不同业务结果。
在 spring web 中，可通过将 `@requestparam(required = false)` 设为 `false`，使参数缺失时为 `null`、参数存在但无值时为空列表，从而精准区分两种语义：`null` 表示未启用过滤，`empty list` 表示启用了“空值过滤”，二者需返回不同业务结果。
在构建 RESTful API 时，常需根据查询参数的存在性和内容状态做出差异化处理。以列表型查询参数为例，null（参数未传）与 []（参数传了但为空）在业务上往往含义截然不同：
-
null：客户端未提供该过滤条件 → 应忽略此过滤，返回全量数据； - 空列表
[]：客户端明确指定了该过滤条件，且允许匹配数据库中对应字段为NULL的记录 → 需执行IS NULL查询。
Spring 默认将未传参的 @RequestParam List<t></t> 视为 null，但若参数存在却无值（如 /api/items?categories= 或 /api/items?categories），Spring 会初始化一个空列表而非 null——这正是实现语义区分的关键机制。
✅ 正确做法是显式声明 required = false：
@GetMapping("/items")
public ResponseEntity<List<Item>> findItems(
@RequestParam(required = false) List<String> categories) {
if (categories == null) {
// ✅ 未传 categories 参数 → 不加 WHERE 条件，查全部
return ResponseEntity.ok(itemService.findAll());
} else if (categories.isEmpty()) {
// ✅ 传了 categories= 或 categories → 查 categories 字段为 NULL 的记录
return ResponseEntity.ok(itemService.findByCategoriesNull());
} else {
// ✅ 传了非空值（如 categories=a,b,c）→ 按 IN 查询
return ResponseEntity.ok(itemService.findByCategories(categories));
}
}? 请求行为对照表：
| 请求 URL | categories 值 | 说明 |
|--------------------------|------------------|------------------------------|
| /items | null | 参数完全未出现 |
| /items?categories= | []（空列表） | 参数存在，值为空字符串 |
| /items?categories | []（空列表） | 参数存在，无等号与值（Spring 5.3+ 支持） |
| /items?categories=a,b | ["a", "b"] | 正常解析为两个元素 |
⚠️ 注意事项：
-
避免依赖客户端拼接
categories=：部分 HTTP 客户端或网关可能自动移除尾部等号，导致行为不一致； -
不建议用
String+ 手动分割：丧失类型安全与 Spring 自动绑定优势； -
强烈建议 API 文档明确标注：在 OpenAPI/Swagger 中使用
nullable: true并补充说明empty array means "filter for NULL"； -
长远考虑重构 API：如业务逻辑复杂，可引入独立布尔参数（如
?filterByCategories=false）或专用 DTO，提升可读性与健壮性。
总之，@RequestParam(required = false) 是 Spring 提供的轻量、标准且可靠的解决方案，无需新增参数即可实现 null 与 empty list 的精确语义分离。
