核心是将空值判断逻辑从SQL拼接中剥离，提升清晰性、安全性与可维护性；通过Optional.ofNullable统一处理非必填字段的判空、去空格、有效性校验等，避免冗余if判断。
用 Optional.ofNullable 处理前端非必填搜索条件，核心不是为了“炫技”，而是把空值判断逻辑从 SQL 拼接过程里剥离出来，让条件组装更清晰、更安全、更易维护。
明确哪些字段是“可能为空”的搜索条件
前端传来的 JSON 中，像 userName、status、startTime、endTime 这类字段通常是非必填的。后端接收时用 String、Integer、LocalDateTime 等包装类型（而非基本类型），才能自然兼容 null。
例如：
DTO 定义示例：public class UserSearchDTO {
private String userName;
private Integer status;
private LocalDateTime startTime;
private LocalDateTime endTime;
// getter/setter...
}用 Optional 封装每个条件，统一做“有值才参与拼接”判断
不推荐写一堆 if (dto.getUserName() != null && !dto.getUserName().trim().isEmpty()) —— 冗长且易漏判。改用 Optional 可以把“判空 + 判空字符串 + 判时间有效性”等逻辑封装起来，再链式处理。
立即学习“前端免费学习笔记（深入）”；
例如（Java 8+）：
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
List<Object> params = new ArrayList<>();
StringBuilder sql = new StringBuilder("SELECT * FROM user WHERE 1=1");
<p>Optional.ofNullable(dto.getUserName())
.filter(s -> !s.trim().isEmpty())
.ifPresent(name -> {
sql.append(" AND user_name LIKE ?");
params.add("%" + name.trim() + "%");
});</p><p>Optional.ofNullable(dto.getStatus())
.ifPresent(status -> {
sql.append(" AND status = ?");
params.add(status);
});</p><p>Optional.ofNullable(dto.getStartTime())
.ifPresent(start -> {
sql.append(" AND create_time >= ?");
params.add(start);
});</p><p>Optional.ofNullable(dto.getEndTime())
.ifPresent(end -> {
sql.append(" AND create_time <= ?");
params.add(end);
});这样每段逻辑职责单一：只关心自己这个字段要不要加、加什么、参数是什么。
避免常见陷阱：字符串空格、数字范围、时间精度
Optional.ofNullable 只解决 null 问题，但业务上还需考虑：
-
字符串去空格再判空：用户可能只输入了空格，
" "不等于null，但也不该作为有效查询条件； -
数值型字段注意边界合理性：比如
status = -999可能是前端默认占位值，应过滤掉； -
时间字段注意时区与精度：
LocalDateTime没有时区，入库前确认数据库字段类型匹配（如DATETIME而非TIMESTAMP）；若需包含当天全部时间，endTime建议自动转为end.toLocalDate().plusDays(1).atStartOfDay()。
进阶建议：抽离成通用条件构建器
当搜索条件变多（>5 个），可封装一个轻量 WhereBuilder 工具类，内部用 Optional + 函数式接口驱动：
public class WhereBuilder {
private final StringBuilder sql = new StringBuilder();
private final List<Object> params = new ArrayList<>();
<pre class="brush:php;toolbar:false;">public WhereBuilder() {
sql.append(" WHERE 1=1");
}
public <T> WhereBuilder like(String column, Optional<T> value, Function<T, String> formatter) {
value.filter(Objects::nonNull)
.map(formatter)
.filter(s -> !s.trim().isEmpty())
.ifPresent(v -> {
sql.append(" AND ").append(column).append(" LIKE ?");
params.add(v);
});
return this;
}
public <T> WhereBuilder eq(String column, Optional<T> value) {
value.filter(Objects::nonNull).ifPresent(v -> {
sql.append(" AND ").append(column).append(" = ?");
params.add(v);
});
return this;
}
public String getSql() { return sql.toString(); }
public List<Object> getParams() { return params; }}
调用就更干净：
WhereBuilder builder = new WhereBuilder();
builder.like("user_name", Optional.ofNullable(dto.getUserName()), s -> "%" + s.trim() + "%")
.eq("status", Optional.ofNullable(dto.getStatus()))
.eq("create_time", Optional.ofNullable(dto.getStartTime()).map(t -> t));
<p>String sql = builder.getSql();
List<Object> params = builder.getParams();不复杂但容易忽略：Optional 是工具，不是银弹。它让空值处理显式化、函数化，但真正安全的 SQL 拼接，还得靠参数化（杜绝字符串拼接值）、字段白名单（防注入列名）、以及对业务语义的准确理解。
