MyBatis-Plus指定字段模糊查询：注解配置与Oracle兼容处理

MyBatis-Plus 模糊查询原理

在 MyBatis-Plus（以 3.3.0 及以上版本为例）中，Entity 实体类字段默认为全字符匹配。要实现模糊查询，核心在于修改字段的查询条件类型。

通过在 Entity 的字段上添加 @TableField 注解，并设置其 condition 属性，即可覆盖默认的查询行为。查看官方源码中的 SqlCondition 类可知，系统预定义了多种查询操作符：

这些选项包括：EQUAL（等于）、NILIKE（右模糊）、BILIKE（左模糊或左右模糊的组合），以及其他常用匹配方式。默认情况下，如果未指定该属性，系统将采用 EQUAL 等值匹配。

标准配置方法

假设我们需要在前端展示时，对名为 title 的字段支持模糊查询，只需在对应的 Java 实体类中进行如下改造：

// 导入必要的注解
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.SqlMethod;

public class YourEntity {
    // ... other fields

    /**
     * 配置该字段始终使用 LIKE '%value%' 方式查询
     */
    @TableField(condition = SqlCondition.LIKE)
    private String title;
}

配置完成后，在使用 QueryWrapper 或 LambdaQueryWrapper 调用 .like() 方法时，生成的 SQL 将自动包含通配符。

Oracle 数据库的兼容性问题

上述配置在 MySQL、PostgreSQL 等大多数数据库中运行良好。但如果项目使用的是 Oracle 数据库，直接使用该注解可能会引发 SQL 语法错误。例如，MyBatis-Plus 默认生成的 SQL 可能如下所示：

SELECT COUNT(1) FROM TEST_TABLE WHERE TITLE LIKE CONCAT('%', '激光', '%');

报错原因： Oracle 数据库内置的 CONCAT 函数仅支持两个参数（如 CONCAT(a, b)），不支持三个或更多参数的拼接。而上面的语句试图拼接三个部分（前缀 %、关键词、后缀 %），导致解析失败。

解决方案： 为了避免冲突，建议定义一个自定义的常量类或直接在注解中引用正确的占位符逻辑。最稳妥的方式是不使用框架默认的 SqlCondition.LIKE，而是定义一个自定义的条件常量，确保生成的 SQL 符合目标数据库的语法。

我们可以定义一个简单的静态常量类或直接在代码中使用字符串替换，但更优雅的做法是保持 @TableField 不变，转而修改 condition 指向的逻辑实现，或者直接使用数据库特定的语法。不过，由于 @TableField 的 condition 属性接受的是字符串常量名，我们通常的做法是自定义一个类似于 SqlCondition 的类：

在实际操作中，若必须使用 Oracle，且发现默认 SqlCondition.LIKE 生成的拼接方式不兼容，可以手动构造 Wrapper 条件，或者确保你的 MyBatis-Plus 版本及插件配置中能识别 Oracle 的特性。但在许多场景下，简单的做法是直接忽略此注解带来的自动拼接，而在 Service 层手动构建 Like 条件，或者确认所使用的 ORM 版本是否已适配 Oracle 的 Concat 限制。对于旧版本或非原生适配环境，**自定义一个模拟 LIKE 行为的占位符或仅在 MySQL 环境下使用该注解**是常见的规避手段。

总结来说，若在 Oracle 下遇到类似 `CONCAT` 参数过多的报错，请检查生成的 SQL 片段。如果无法快速升级依赖，建议在 Service 层放弃全局注解配置，转而针对特定查询方法手动组装 LIKE 字符串（如 "'%' || keyword || '%'"），这能彻底绕过框架层面的 Dialect 差异。

以上就是 MyBatis-Plus 指定字段模糊查询及 Oracle 兼容处理的详细内容，更多关于 MyBatis-Plus 字段模糊查询的资料请关注本站其它相关文章！