Java Stream API 通过组合 Predicate 实现动态条件过滤：以 Predicate.identity() 起始，按需 and() 追加非空条件，支持短路求值、一次遍历、高可读性与可测试性，并需注意 null 安全、无副作用及复杂场景选型。
Java 中 Stream API 本身不直接支持“动态拼接条件”，但可以通过组合 Predicate 实现多条件动态过滤，核心思路是：把每个条件封装为独立的 Predicate<T>，再用 and()、or()、negate() 动态组合，最后统一应用到 stream 上。
用 Predicate 组合实现动态条件
每个查询条件（如用户名非空且包含某字符串、年龄在范围内、状态为启用）都可写成一个 Predicate<User>。初始设为 Predicate.identity()（恒真），再根据参数是否有效，依次 and() 追加条件。
- 避免重复遍历：所有条件在一次 stream 流中完成判断，不是逐个 filter
- 短路求值：and 组合时，前面条件为 false 就不再执行后续判断
- 可读性强：逻辑清晰分离，易于单元测试单个条件
典型写法示例（含空值与范围校验）
假设查询用户列表，支持按 name（模糊）、ageRange（闭区间）、status（枚举）动态过滤：
Predicate<User> predicate = Predicate.identity();
if (StringUtils.isNotBlank(query.getName())) {
predicate = predicate.and(u -> u.getName() != null && u.getName().contains(query.getName()));
}
if (query.getMinAge() != null || query.getMaxAge() != null) {
int min = query.getMinAge() != null ? query.getMinAge() : 0;
int max = query.getMaxAge() != null ? query.getMaxAge() : Integer.MAX_VALUE;
predicate = predicate.and(u -> u.getAge() >= min && u.getAge() <= max);
}
if (query.getStatus() != null) {
predicate = predicate.and(u -> query.getStatus() == u.getStatus());
}
List<User> result = users.stream().filter(predicate).collect(Collectors.toList());
进阶技巧：构建可复用的条件工厂
把常用条件逻辑抽成静态方法，提升复用性与可测性：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- StringContains：安全处理 null 字段 + 忽略大小写
-
InStatus：支持多状态 OR 匹配（
predicate.or(...)） - Between：支持数字/日期范围，自动处理 null 边界
例如：Predicate<User> nameLike = Predicates.containsIgnoreCase(User::getName, query.getName());
注意事项与避坑点
动态组合看似简单，实际容易出错：
- 字段为 null 时直接调用方法会 NPE，务必先判空或用 Optional 包装（但注意 stream 中不宜滥用 Optional）
- 不要在 predicate 内部修改原对象状态（违反函数式原则，影响并行流）
- 大量条件 or 组合时性能可能下降，可考虑提前用 if 分支分流
- 复杂业务场景建议配合 QueryDSL 或 MyBatis-Plus 的 LambdaQueryWrapper，Stream 更适合内存计算
