MyBatis-Plus中如何正确使用gt和lt实现动态查询条件？

Question

在MyBatis-Plus开发中，如何正确使用`gt`（大于）和`lt`（小于）方法构建动态查询条件是一个常见问题。例如，当需要根据用户输入动态生成“年龄大于某个值”或“创建时间小于某个值”的查询时，直接使用`queryWrapper.gt("age", age)`或`queryWrapper.lt("createTime", time)`可能会导致空值异常或无效SQL。 **问题：** 当参数可能为空时，如何避免生成错误的SQL？例如，若`age`为`null`，`gt("age", age)`会导致SQL语法错误。 解决此问题的关键在于结合条件判断，使用链式调用或提前过滤空值。例如： ```java if (age != null) { queryWrapper.gt("age", age); } if (time != null) { queryWrapper.lt("createTime", time); } ``` 或者利用MyBatis-Plus的内置特性，如`apply`方法自定义SQL片段，确保查询条件的安全性和灵活性。

Answer 1

1. 问题背景与常见误区

在MyBatis-Plus开发中，动态查询条件的构建是一个高频需求。例如，根据用户输入生成“年龄大于某个值”或“创建时间小于某个值”的查询条件时，开发者可能会直接使用`queryWrapper.gt("age", age)`或`queryWrapper.lt("createTime", time)`。然而，如果参数可能为空，这种做法会导致SQL语法错误。

以下代码展示了常见的错误用法：

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.gt("age", age); // 如果 age 为 null，将导致 SQL 错误
queryWrapper.lt("createTime", time); // 如果 time 为 null，同样会出错
    

此问题的核心在于未对空值进行有效处理，从而影响了SQL语句的正确性。

2. 解决方案：条件判断与链式调用

为了规避上述问题，最直接的方式是通过条件判断来过滤空值。以下是推荐的解决方案：

• 方法一：显式条件判断

if (age != null) {
    queryWrapper.gt("age", age);
}
if (time != null) {
    queryWrapper.lt("createTime", time);
}
    

通过这种方式，可以确保只有非空参数才会被加入到查询条件中。

• 方法二：使用 Lambda 表达式

queryWrapper.lambda()
    .gt(age != null, User::getAge, age)
    .lt(time != null, User::getCreateTime, time);
    

Lambda 表达式提供了更简洁的语法，同时保留了对空值的判断能力。

3. 高级特性：利用 `apply` 方法自定义 SQL 片段

除了基本的条件判断外，MyBatis-Plus 还提供了更灵活的工具——`apply` 方法，允许开发者手动拼接 SQL 片段。例如：

if (age != null) {
    queryWrapper.apply("age > {0}", age);
}
if (time != null) {
    queryWrapper.apply("create_time < {0}", time);
}
    

`apply` 方法不仅支持动态插入参数，还能够完全掌控生成的 SQL 逻辑，适用于复杂查询场景。

4. 流程图解析

以下流程图描述了如何在 MyBatis-Plus 中安全地构建动态查询条件：

graph TD;
            A[开始] --> B{参数是否为空？};
            B -- 是 --> C[跳过该条件];
            B -- 否 --> D[添加查询条件];
            D --> E[继续检查其他参数];
            E --> F{还有参数吗？};
            F -- 是 --> G[返回 B];
            F -- 否 --> H[结束];

通过这样的流程，可以系统化地避免空值带来的问题。

5. 性能与安全性分析

在实际开发中，除了功能实现外，还需关注性能与安全性：

方法	优点	缺点
显式条件判断	简单直观，易于维护	代码冗长，尤其当条件较多时
Lambda 表达式	语法简洁，表达力强	需要熟悉 Java 8+ 的语法特性
`apply` 方法	高度灵活，适合复杂查询	可能增加 SQL 注入风险，需谨慎使用

因此，在选择具体实现方式时，应综合考虑项目需求、团队技术水平及潜在风险。