在日常開(kāi)發(fā)中，我們經(jīng)常使用 MyBatis Plus 進(jìn)行數(shù)據(jù)庫(kù)查詢(xún)。其中，LIKE 關(guān)鍵字用于模糊匹配，但如果用戶(hù)輸入的查詢(xún)條件包含 %，可能會(huì)導(dǎo)致查詢(xún)結(jié)果異常。

如下圖,數(shù)據(jù)庫(kù)里面是沒(méi)有%的plate_number數(shù)據(jù)的,但是查詢(xún)出86條數(shù)據(jù)

問(wèn)題分析

我們來(lái)看一段 MyBatis Plus 的查詢(xún)代碼：

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()非空，則執(zhí)行 LIKE 查詢(xún)。
• 例如，用戶(hù)輸入 "ABC"，SQL 語(yǔ)句應(yīng)為：

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

這樣可以查詢(xún)出包含 "ABC" 的所有車(chē)牌。

問(wèn)題出現(xiàn)的情況

• 如果用戶(hù)輸入了 %，如 "%"，SQL 會(huì)變成：

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

由于 % 在 SQL LIKE 語(yǔ)句中是通配符，它會(huì)匹配任意字符，這可能導(dǎo)致匹配出比預(yù)期更多的數(shù)據(jù)。

• 如果用戶(hù)僅輸入 %，則 LIKE '%%%' 會(huì)匹配所有數(shù)據(jù)，完全失去篩選作用。

查詢(xún)結(jié)果不符合預(yù)期，可能導(dǎo)致：

1. 查詢(xún)數(shù)據(jù)量過(guò)大，影響系統(tǒng)性能。
2. 業(yè)務(wù)邏輯錯(cuò)誤，返回了不相關(guān)的數(shù)據(jù)。

解決方案

方法 1：去除%，只匹配真實(shí)字符（不推薦）

一種簡(jiǎn)單的方式是移除 %，讓 LIKE 只匹配實(shí)際輸入的內(nèi)容。

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);

缺點(diǎn)：

• 如果用戶(hù)查詢(xún) "100%ABC"，會(huì)變成 "100ABC"，查詢(xún)結(jié)果不準(zhǔn)確。
• 失去了 % 作為普通字符的意義，不能搜索包含 % 的數(shù)據(jù)。

方法 2：使用eq()進(jìn)行精確匹配（適用于完全匹配查詢(xún)）

如果 plateNumber 是用戶(hù)完整輸入的車(chē)牌號(hào)，VIN 碼和 車(chē)型名 也是完整的，則可以使用 eq()：

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

優(yōu)點(diǎn)：

• 精準(zhǔn)匹配，不會(huì)因?yàn)?% 影響查詢(xún)結(jié)果。
• 適用于 VIN 碼、車(chē)牌號(hào)等完整匹配的查詢(xún)。

缺點(diǎn)：

• 不能進(jìn)行模糊匹配，用戶(hù)必須輸入完整的車(chē)牌號(hào)或 VIN 才能查到數(shù)據(jù)。

方法 3：使用轉(zhuǎn)義%（推薦本次使用）**

將%和_使用escapeLike方法轉(zhuǎn)義轉(zhuǎn)義

Java 代碼

// 處理 LIKE 查詢(xún)參數(shù)，轉(zhuǎn)義 % 和 _
String escapeLike(String str) {
return str != null ? str.replace("%", "\\%").replace("_", "\\_").trim() : null;
}

// 轉(zhuǎn)義參數(shù)
String plateNumber = escapeLike(reqVo.getPlateNumber());
String vin = escapeLike(reqVo.getVin());
String modelName = escapeLike(reqVo.getModelName());

// 避免 `null` 參數(shù)
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 解析

如果用戶(hù)輸入 "100%ABC"，SQL 語(yǔ)句會(huì)變成：

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

• % 讓 % 變成普通字符，不再作為通配符。
• 這樣可以正確匹配 100%ABC，而不會(huì)匹配 100XYZABC。

優(yōu)點(diǎn)：

• 支持模糊查詢(xún)，但不會(huì)誤匹配。
• 不會(huì)影響查詢(xún)數(shù)據(jù)的完整性，能夠正確匹配包含 % 的車(chē)牌號(hào)或 VIN。

修改后執(zhí)行結(jié)果

• 可以看到查詢(xún)正常了
• 在這里插入圖片描述

最佳實(shí)踐推薦

綜合來(lái)看，方法 3（使用 ESCAPE）是最優(yōu)解，兼顧了模糊匹配和 % 作為普通字符的問(wèn)題。

總結(jié)

在 MyBatis Plus LIKE 查詢(xún)時(shí)，如果 plateNumber、vin 或 modelName 含有 %，會(huì)導(dǎo)致誤匹配。

直接 LIKE '%' 會(huì)查詢(xún)所有數(shù)據(jù)，可能影響業(yè)務(wù)邏輯。

解決方案：

1. 去掉 %（不推薦）
2. 改用 eq() 精確匹配（適用于完整匹配）
3. 使用 ESCAPE 轉(zhuǎn)義 %（推薦）

正確使用 LIKE 查詢(xún)，能避免數(shù)據(jù)誤匹配，提高查詢(xún)準(zhǔn)確性和系統(tǒng)性能！

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論