前言
前一篇我们聊了 MySQL 隐式转换导致索引失效的问题,很多同学看完觉得:只要数据库字段类型对齐就不会踩坑。 但在 MyBatis-Plus 开发中,Lambda 写法一样会触发隐式转换的陷阱,而且隐蔽性更强。 Lambda 把 SQL 封装起来,我们看不到最终生成的语句,一不小心参数类型不匹配,就悄悄触发隐式转换,索引直接失效,线上慢查询就是这么来的。
系列文章:上一篇:MySQL 隐式转换索引失效踩坑|一个引号引发全表扫描
场景还原
数据库表:ods_lx_fba_warehouse_detail seller_sku 字段:varchar 字符串类型,已经建立索引。 业务需求:根据 sid + sellerSku,查询 3 天内最新一条同步记录,初始代码如下:
perl
default OdsLxFbaWarehouseDetailDO selectLatestBySidAndSellerSku(Long sid, String sellerSku) {
// 仅取三天内同步的数据,避免拿到过期历史数据
LocalDateTime threeDaysAgo = LocalDateTime.now().minusDays(3);
return selectOne(new LambdaQueryWrapperX<OdsLxFbaWarehouseDetailDO>()
.eq(OdsLxFbaWarehouseDetailDO::getSid, sid)
.eq(OdsLxFbaWarehouseDetailDO::getSellerSku, sellerSku)
.gt(OdsLxFbaWarehouseDetailDO::getSyncDate, threeDaysAgo)
.orderByDesc(OdsLxFbaWarehouseDetailDO::getSyncDate)
.last("LIMIT 1"));
}
✅ 正常情况:sellerSku 传入字符串,生成 SQL 带引号,正常走索引,查询很快。
❌ 踩坑场景: 如果上游传入的 sku 本质是数字,代码直接把数字类型传给eq,MyBatis-Plus 生成 SQL 会变成:
ini
WHERE seller_sku = 123456
字段是 varchar,等号右侧是数字,触发 MySQL 隐式转换,索引失效,变成全表扫描。
重点:Lambda 看不到原始 SQL,不像手写 SQL 一眼就能发现少了引号,很容易忽略参数类型问题!
对比:原生 SQL vs MP 生成 SQL
正确 SQL(带引号,走索引)
sql
SELECT * FROM ods_lx_fba_warehouse_detail
WHERE seller_sku = '123456'
ORDER BY sync_date DESC LIMIT 1;
错误 SQL(无引号,隐式转换,索引失效)
sql
SELECT * FROM ods_lx_fba_warehouse_detail
WHERE seller_sku = 123456
ORDER BY sync_date DESC LIMIT 1;
怎么快速排查
- 开启 MyBatis-Plus 日志,打印最终执行 SQL,观察条件值是否自带引号
yaml
# application.yml
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
- 拿到 SQL 前面加
EXPLAIN查看执行计划
type字段如果不是ref,变成ALL,代表全表扫描,踩坑了
- 核对入参:传给
eq的值类型,和数据库字段类型保持一致
解决方案
- 入参强制转为 String,无论上游传数字还是字符串,统一转字符串再放入 eq
perl
.eq(OdsLxFbaWarehouseDetailDO::getSellerSku, String.valueOf(sellerSku))
- DO 实体类规范定义:varchar 对应 String、bigint 对应 Long,实体字段和数据库类型严格对齐
- 代码评审重点关注 sku、编码这类经常数字、字符串混用的字段
- 线上接入慢查询监控,及时捕获全表扫描的 SQL
额外延伸:trim () 的坑(很多人搞错)
很多开发为了去除前后空格,会这样写:
perl
// ✅ 安全:对参数trim,不会影响索引
.eq(OdsLxFbaWarehouseDetailDO::getSellerSku, sellerSku.trim())
⚠️ 千万不要在数据库字段上套函数!
sql
-- ❌ 错误!字段上使用函数,索引直接失效
WHERE trim(seller_sku) = 'xxx'
简单区分:trim 作用在入参没问题;trim 作用在数据库字段,索引失效。
总结
markdown
1. LambdaQueryWrapper 写法简洁优雅,但屏蔽了底层SQL,很容易忽略参数类型匹配问题,踩坑更隐蔽。
2. varchar 字段做等值查询,条件右侧必须是字符串;直接传入数字,会触发MySQL隐式转换,索引失效。
3. 通用排查套路:开启日志打印SQL → explain查看执行计划 → 对齐入参和数据库字段类型。
4. 额外记住:trim() 作用在传入参数没问题;**不要在数据库字段上套函数**,同样会毁掉索引。
5. 隐式转换是线上慢查询高频元凶,写查询条件时一定要养成类型校验的习惯。
> 上一篇:MySQL 隐式转换索引失效踩坑|一个引号引发全表扫描