Optional.ofNullable用于处理非必填搜索参数，核心是利用isPresent/ifPresent语义明确性避免null拼入SQL；通过filter链式校验（如非空、范围、时间）提升可读性与健壮性，配合MyBatis动态SQL或DTO预过滤实现安全查询。
用 Optional.ofNullable 处理前端传来的非必填搜索参数，核心不是“包装对象”，而是借助其 isPresent() 和 ifPresent() 的语义明确性，让 SQL 拼接逻辑更清晰、不易漏判空值，避免 NullPointerException 或错误包含 null 条件。
避免直接拼接 null 值导致 SQL 语法错误
前端搜索字段（如用户名、状态、开始时间）常为非必填，后端接收时可能为 null。若直接写 "AND username = '" + param.getUsername() + "'"，当 getUsername() 返回 null，SQL 变成 AND username = 'null'，查不到数据且难以排查。
用 Optional.ofNullable(param.getUsername()) 明确表达“这个值可能不存在”，再决定是否追加条件：
StringBuilder sql = new StringBuilder("SELECT * FROM user WHERE 1=1");
Optional.ofNullable(param.getUsername())
.filter(username -> !username.trim().isEmpty())
.ifPresent(username -> sql.append(" AND username LIKE '%").append(username).append("%')"));
<p>Optional.ofNullable(param.getStatus())
.ifPresent(status -> sql.append(" AND status = ").append(status));</p>链式过滤提升可读性与健壮性
Optional 的 filter() 可自然衔接校验逻辑，比如对字符串去空、对数字范围检查，避免嵌套 if：
立即学习“前端免费学习笔记（深入）”；
-
filter(s -> s != null && !s.trim().isEmpty())→ 空字符串不参与查询 -
filter(id -> id > 0)→ 排除非法 ID -
filter(date -> !date.isAfter(Year.now().plusYears(1)))→ 时间不过期
每一步都返回 Optional，语义连贯，比传统 if-else 更聚焦“什么条件下才生效”。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
配合 MyBatis 动态 SQL 更安全（推荐组合用法）
纯字符串拼接易 SQL 注入且难维护。更推荐在 MyBatis 的 XML 中用 <if test="xxx != null and xxx != ''">，而 Java 层用 Optional 做前置校验或封装 DTO：
// 封装搜索参数，构造时就过滤无效值
public class UserSearchDTO {
private final String username;
private final Integer status;
<pre class='brush:java;toolbar:false;'>public UserSearchDTO(String username, Integer status) {
this.username = Optional.ofNullable(username)
.filter(s -> !s.trim().isEmpty())
.map(String::trim)
.orElse(null);
this.status = Optional.ofNullable(status)
.filter(s -> s > 0)
.orElse(null);
}
// getter...}
这样传给 MyBatis 的对象字段天然“干净”，XML 中只需简单判空，减少重复逻辑。
注意边界：Optional 不解决所有问题
Optional.ofNullable 是工具，不是银弹：
- 不要在 DTO 字段上直接声明
Optional<String>—— Jackson 默认不支持反序列化，且违背 DTO 简单性原则 - 数据库字段为
NULL时，SQL 中应写IS NULL而非= null，Optional本身不自动转换这种语义 - 大量条件拼接建议改用 QueryWrapper（MyBatis-Plus）或 Criteria API（JPA），它们内置空值跳过机制，比手写 Optional 更简洁
它真正价值在于让“空值分支”显性化、不可忽略，降低动态 SQL 的维护成本。
