MyBatis-Plus LambdaQueryWrapper 隐式转换踩坑:不知不觉索引失效

前言

前一篇我们聊了 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;

怎么快速排查

  1. 开启 MyBatis-Plus 日志,打印最终执行 SQL,观察条件值是否自带引号
yaml 复制代码
# application.yml
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  1. 拿到 SQL 前面加 EXPLAIN 查看执行计划
  • type 字段如果不是 ref,变成 ALL,代表全表扫描,踩坑了
  1. 核对入参:传给eq的值类型,和数据库字段类型保持一致

解决方案

  1. 入参强制转为 String,无论上游传数字还是字符串,统一转字符串再放入 eq
perl 复制代码
.eq(OdsLxFbaWarehouseDetailDO::getSellerSku, String.valueOf(sellerSku))
  1. DO 实体类规范定义:varchar 对应 String、bigint 对应 Long,实体字段和数据库类型严格对齐
  2. 代码评审重点关注 sku、编码这类经常数字、字符串混用的字段
  3. 线上接入慢查询监控,及时捕获全表扫描的 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 隐式转换索引失效踩坑|一个引号引发全表扫描
相关推荐
用户37215742613512 分钟前
Java 在 PDF 中查找关键词:获取页码和坐标,并高亮匹配结果
java
Forget the Dream38 分钟前
Spring AI 2.0 系列(三):ChatClient 与 ChatModel:Spring AI 2.0 的两层职责
java·人工智能·spring·springai
Rain的Java大神之路2 小时前
把数组本身变成哈希表:原地哈希搞定 LeetCode 41「缺失的第一个正数」
java·后端·leetcode
山楂树の2 小时前
Java 泛型:泛型类、泛型方法、泛型接口与通配符
java·开发语言·笔记
跳跳的小古风3 小时前
前端转全栈:一条接口从前端请求到 SQL 完整流程
java·前端
jianqiang.xue4 小时前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
ikgy5 小时前
JAVA EE:4.多线程核心组件实战
java·java-ee
杨凯凡6 小时前
IT日报|2026-11-19:Oracle Java 紧急补丁、Optimizely 供应链攻击、GitHub 安全评估升级
java·oracle·github
JasonChen@6666 小时前
2.Tomcat 安装部署与一键自动化脚本实战
java·tomcat