MyBatis-Plus Mapper 常见问题：如何实现复杂查询？

Question

在使用 MyBatis-Plus 进行开发时，虽然其封装的 `Wrapper` 查询构造器能够满足大部分单表查询需求，但在面对多表关联、嵌套查询、动态条件拼接等复杂查询场景时，开发者常常遇到查询构建困难、SQL 可读性差、性能优化受限等问题。例如，如何在不脱离 MyBatis-Plus 的基础上实现多表联合查询？如何在复杂条件下动态拼接 SQL 语句？又如何结合原生 SQL 与 Wrapper 进行混合查询？这些问题成为使用 MyBatis-Plus 实现复杂查询时的常见痛点。本文将围绕这些问题展开分析与解决方案探讨。

Answer 1

一、MyBatis-Plus Wrapper 的局限性与复杂查询挑战

MyBatis-Plus 提供的 Wrapper 查询构造器极大地简化了单表查询逻辑，但在实际开发中，面对多表关联、嵌套查询、动态条件拼接等复杂业务场景时，其封装性反而成为限制因素。例如：

• 无法直接支持多表联合查询（JOIN）
• 嵌套子查询逻辑难以通过 Lambda 表达式构建
• 复杂条件的动态拼接容易导致 SQL 结构混乱
• 性能优化（如索引使用、分页优化）受限于 Wrapper 生成的 SQL

这些问题促使开发者在不脱离 MyBatis-Plus 框架的前提下，寻找更灵活、可维护、高性能的复杂查询实现方式。

二、多表联合查询的实现方式

MyBatis-Plus 本身并未提供多表查询的封装方法，但可以通过以下方式进行扩展：

1. 自定义 SQL + Wrapper 混合使用：在 Mapper XML 文件中编写 JOIN 查询语句，通过 Wrapper 构建 WHERE 条件部分。
2. 使用 QueryWrapper 的 apply 方法：通过 apply() 方法直接拼接原生 SQL 片段。
3. 继承 Wrapper 自定义扩展类：构建支持多表字段的 Wrapper 子类。

queryWrapper.apply("u.user_id = o.user_id")
    .eq("u.status", 1)
    .ge("o.amount", 1000);

上述代码片段通过 apply 方法实现了 user 表与 order 表的联合查询条件拼接。

三、动态条件拼接的优化策略

在构建复杂查询时，动态条件的拼接是常见需求。以下为优化策略：

策略	说明
使用 LambdaQueryWrapper	通过 Java 8 的 Lambda 表达式提升可读性与类型安全
条件判断封装	将条件判断逻辑封装为独立方法，提高复用性
结合 if-else 或策略模式	根据业务逻辑动态构建不同的查询条件

LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>();
if (StringUtils.isNotBlank(name)) {
    wrapper.like(User::getName, name);
}
if (age != null) {
    wrapper.eq(User::getAge, age);
}

四、Wrapper 与原生 SQL 的混合查询实践

在某些场景下，开发者希望保留 Wrapper 的条件构建能力，同时使用原生 SQL 的灵活性。可以通过以下方式实现：

• 使用 Wrapper 的 SQL 片段提取：调用 targetSql() 方法获取生成的 WHERE 子句。
• 在 XML 文件中组合 SQL：将 Wrapper 生成的条件拼接到自定义 SQL 中。

String condition = queryWrapper.getTargetSql();
String finalSql = "SELECT * FROM user u JOIN order o ON u.id = o.user_id WHERE " + condition;

graph TD
A[Wrapper 构建条件] --> B[提取 SQL 条件片段]
B --> C[拼接到原生 SQL]
C --> D[执行最终查询]