MyBatis-Plus 使用 QueryWrapper 如何实现去重查询？

Question

在使用 MyBatis-Plus 进行数据库查询时，开发者常会遇到需要去除重复记录的场景。虽然 QueryWrapper 提供了丰富的方法构建查询条件，但其本身并不直接支持去重操作。那么，如何借助 QueryWrapper 实现类似 SQL 中 `DISTINCT` 的去重查询效果？是否可以通过结合原生 SQL、LambdaQueryWrapper 或自定义 SQL 语句来完成这一需求？此外，在进行去重时，又该如何避免影响查询性能或导致结果不准确的问题？本文将围绕这些问题，深入探讨在不同业务场景下，使用 MyBatis-Plus 和 QueryWrapper 实现高效去重查询的几种常见方案，并分析其适用场景与潜在问题。

Answer 1

MyBatis-Plus 中使用 QueryWrapper 实现去重查询的实践与优化

在数据库操作中，去重（DISTINCT）是一个常见的需求。然而，MyBatis-Plus 的 QueryWrapper 并未直接提供类似 SQL 中 DISTINCT 的方法。本文将围绕如何借助 QueryWrapper、LambdaQueryWrapper 以及自定义 SQL 来实现去重查询，并探讨其性能影响和适用场景。

一、基础理解：QueryWrapper 与 DISTINCT 的关系

MyBatis-Plus 提供了 QueryWrapper 和 LambdaQueryWrapper 用于构建动态查询条件，但它们并不支持直接添加 DISTINCT 关键字。开发者通常会尝试通过 select 方法指定字段，但并未解决去重问题。

• QueryWrapper 默认返回实体对象，无法直接进行字段级去重
• LambdaQueryWrapper 同样受限于底层封装
• SELECT 子句中缺少对 DISTINCT 的显式支持

二、方案一：结合原生 SQL 实现去重

最直接有效的方式是使用 MyBatis-Plus 的原生 SQL 支持，通过 @Select 注解或 XML 文件编写带有 DISTINCT 的 SQL 查询语句。

@Select("SELECT DISTINCT name FROM user WHERE age > #{age}")
List findDistinctNamesByAge(int age);
    

此方式适用于以下场景：

适用场景	说明
字段较少且需精确去重	如用户名称、分类标签等单一字段
性能敏感业务	可控制索引使用，避免全表扫描

三、方案二：使用 selectObjs 或自定义 Wrapper 拼接 DISTINCT

通过 selectObjs 方法可以执行任意字段查询，并结合字符串拼接 DISTINCT 关键字。

List<Object[]> result = userMapper.selectObjs(new QueryWrapper<User>()
    .select(User.class, info -> !info.getColumn().equals("id"))
    .apply("DISTINCT {0}", "name"));
    

该方式的优点在于：

• 保留 QueryWrapper 的链式调用风格
• 可通过 apply 方法灵活注入 SQL 片段

但也存在如下潜在问题：

1. 结果为 Object[]，需要手动转换类型
2. 容易引入 SQL 注入风险，需谨慎使用

四、方案三：自定义 SQL + 分页插件实现高效去重

对于大数据量下的分页去重场景，建议使用自定义 SQL 配合 PageHelper 插件来提升性能。

Page<User> page = new Page<>(1, 10);
userMapper.selectPage(page, new QueryWrapper<User>()
    .apply("DISTINCT ON (name)"));
    

流程图如下所示：

graph TD
    A[开始] --> B{是否需要分页?}
    B -- 是 --> C[使用 Page 对象]
    B -- 否 --> D[直接查询列表]
    C --> E[构造包含 DISTINCT 的 SQL]
    D --> E
    E --> F[执行查询并返回结果]

五、性能优化建议与注意事项

去重操作可能带来性能瓶颈，尤其是在数据量大的情况下。以下是几个关键优化建议：

• 确保被去重字段上有合适的索引
• 避免在大表上频繁使用 DISTINCT
• 优先考虑业务逻辑层面去重，而非数据库层
• 合理使用缓存机制减少重复查询

此外，还需注意以下常见错误：

错误类型	后果	解决方案
未正确处理 NULL 值	导致去重结果不准确	使用 COALESCE 处理 NULL
忽略排序影响	分页结果混乱	明确指定 ORDER BY 字段