MyBatis Plus like参数为百分号%查询结果异常原因分析及解决

更新时间：2025年09月25日 09:03:34 作者：_院长大人_

文章指出在MyBatisPlus使用LIKE查询时,用户输入的%可能导致通配符误匹配,推荐使用ESCAPE转义功能,将%转换为普通字符,既支持模糊查询又避免全表匹配,提升准确性和性能

问题分析

我们来看一段 MyBatis Plus 的查询代码：

queryWrapper
    .like(StringUtils.hasText(reqVo.getPlateNumber()), HlCar::getPlateNumber, reqVo.getPlateNumber())
    .like(StringUtils.hasText(reqVo.getVin()), HlCar::getVin, reqVo.getVin())
    .like(StringUtils.hasText(reqVo.getModelName()), HlCar::getCarSeries, reqVo.getModelName());

该代码的意图是：

如果 reqVo.getPlateNumber()、reqVo.getVin() 或 reqVo.getModelName()非空，则执行 LIKE 查询。
例如，用户输入 "ABC"，SQL 语句应为：

SELECT * FROM hl_car WHERE plate_number LIKE '%ABC%'

这样可以查询出包含 "ABC" 的所有车牌。

问题出现的情况

如果用户输入了 %，如 "%"，SQL 会变成：

SELECT * FROM hl_car WHERE plate_number LIKE '%%%'

由于 % 在 SQL LIKE 语句中是通配符，它会匹配任意字符，这可能导致匹配出比预期更多的数据。

如果用户仅输入 %，则 LIKE '%%%' 会匹配所有数据，完全失去筛选作用。

查询结果不符合预期，可能导致：

查询数据量过大，影响系统性能。
业务逻辑错误，返回了不相关的数据。

解决方案

方法 1：去除%，只匹配真实字符（不推荐）

一种简单的方式是移除 %，让 LIKE 只匹配实际输入的内容。

String plateNumber = reqVo.getPlateNumber() != null ? reqVo.getPlateNumber().replace("%", "").trim() : null;
String vin = reqVo.getVin() != null ? reqVo.getVin().replace("%", "").trim() : null;
String modelName = reqVo.getModelName() != null ? reqVo.getModelName().replace("%", "").trim() : null;

queryWrapper
.like(StringUtils.hasText(plateNumber), HlCar::getPlateNumber, plateNumber)
.like(StringUtils.hasText(vin), HlCar::getVin, vin)
.like(StringUtils.hasText(modelName), HlCar::getCarSeries, modelName);

缺点：

如果用户查询 "100%ABC"，会变成 "100ABC"，查询结果不准确。
失去了 % 作为普通字符的意义，不能搜索包含 % 的数据。

方法 2：使用eq()进行精确匹配（适用于完全匹配查询）

如果 plateNumber 是用户完整输入的车牌号，VIN 码和 车型名 也是完整的，则可以使用 eq()：

queryWrapper.eq(StringUtils.hasText(plateNumber), HlCar::getPlateNumber, plateNumber)
.eq(StringUtils.hasText(vin), HlCar::getVin, vin)
.eq(StringUtils.hasText(modelName), HlCar::getCarSeries, modelName);

优点：

精准匹配，不会因为 % 影响查询结果。
适用于 VIN 码、车牌号等完整匹配的查询。

缺点：

不能进行模糊匹配，用户必须输入完整的车牌号或 VIN 才能查到数据。

方法 3：使用转义%（推荐本次使用）**

将%和_使用escapeLike方法转义转义

Java 代码

// 处理 LIKE 查询参数，转义 % 和 _
String escapeLike(String str) {
return str != null ? str.replace("%", "\\%").replace("_", "\\_").trim() : null;
}

// 转义参数
String plateNumber = escapeLike(reqVo.getPlateNumber());
String vin = escapeLike(reqVo.getVin());
String modelName = escapeLike(reqVo.getModelName());

// 避免 `null` 参数
if (StringUtils.hasText(plateNumber)) {
    queryWrapper.like(HlCar::getPlateNumber, plateNumber);
}
if (StringUtils.hasText(vin)) {
    queryWrapper.like(HlCar::getVin, vin);
}
if (StringUtils.hasText(modelName)) {
    queryWrapper.like(HlCar::getCarSeries, modelName);
}

SQL 解析

如果用户输入 "100%ABC"，SQL 语句会变成：

SELECT * FROM hl_car WHERE plate_number LIKE '100\%ABC'

% 让 % 变成普通字符，不再作为通配符。
这样可以正确匹配 100%ABC，而不会匹配 100XYZABC。

优点：

支持模糊查询，但不会误匹配。
不会影响查询数据的完整性，能够正确匹配包含 % 的车牌号或 VIN。

修改后执行结果

可以看到查询正常了
在这里插入图片描述

最佳实践推荐

方法	适用场景	是否支持 % 作为普通字符	是否支持模糊匹配
方法 1：去掉%	适用于只需要模糊查询的情况	❌（去掉 % 影响查询结果）	✅
方法 2：用 eq() 精确匹配	适用于 VIN 码、完整车牌匹配	✅	❌
方法 3：用 ESCAPE 转义（推荐）	适用于所有 LIKE 查询	✅	✅

综合来看，方法 3（使用 ESCAPE）是最优解，兼顾了模糊匹配和 % 作为普通字符的问题。

总结

在 MyBatis Plus LIKE 查询时，如果 plateNumber、vin 或 modelName 含有 %，会导致误匹配。

直接 LIKE '%' 会查询所有数据，可能影响业务逻辑。

解决方案：

去掉 %（不推荐）
改用 eq() 精确匹配（适用于完整匹配）
使用 ESCAPE 转义 %（推荐）

正确使用 LIKE 查询，能避免数据误匹配，提高查询准确性和系统性能！

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

java中的this引用及对象构造初始化
这篇文章主要介绍了java中的this引用及对象构造初始化，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的小伙伴可以参考一下
2022-08-08
聊聊Object类中的wait()和notify()方法
这篇文章主要介绍了Object类中的wait()和notify()方法，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-09-09
SpringBoot集成Redis之RedisTemplate实践
文章介绍了在使用SpringBoot与Redis进行交互时,遇到的中文乱码问题,并提供两种解决方法：1) 使用StringRedisTemplate；2) 自定义Redis序列化器,同时,还讨论了在集群模式下,若主机宕机,客户端如何动态感知集群状态
2026-04-04
JavaWeb简单文件上传流程的实战记录
在Web应用系统开发中,文件上传和下载功能是非常常用的功能,下面这篇文章主要给大家介绍了关于JavaWeb实现简单文件上传流程的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
2022-03-03
Java中的OkHttpClient 工具类
这篇文章主要介绍了Java中的OkHttpClient工具类，具有很好的参考价值，希望杜大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-06-06
详解五种方式让你在java中读取properties文件内容不再是难题
这篇文章主要介绍了详解五种方式让你在java中读取properties文件内容不再是难题 ,非常具有实用价值，需要的朋友可以参考下。
2016-12-12
hibernate-validator如何使用校验框架
高效、合理的使用hibernate-validator校验框架可以提高程序的可读性，以及减少不必要的代码逻辑，本文主要介绍了hibernate-validator如何使用校验框架，感兴趣的可以了解一下
2022-04-04
一个简单的java学生寝室查询系统
这篇文章主要为大家详细介绍了一个简单的java学生寝室查询系统，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-10-10
深入浅析java中flyway使用简介
Flyway是独立于数据库的应用、管理并跟踪数据库变更的数据库版本管理工具。这篇文章主要介绍了flyway使用简介,需要的朋友可以参考下
2020-07-07
Spring Boot支持Crontab任务改造的方法
这篇文章主要介绍了Spring Boot支持Crontab任务改造的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-01-01