MyBatis-Plus中Wrappers条件构造器使用orderBy时的注意事项

在使用MyBatis-Plus进行数据库操作时，条件构造器Wrappers是一个非常方便的工具类。然而，在实际开发中，当使用orderBy排序而没有其他条件时，可能会遇到一些意料之外的问题。

问题现象

开发者在使用MyBatis-Plus的Wrappers.lambdaQuery()构造查询条件时，发现当仅使用orderByDesc()方法而没有其他条件时，生成的SQL语句会错误地包含一个空的WHERE子句，导致SQL执行报错。

示例代码：

Page subscribeVersionVOPage = this.baseMapper.selectSubList(
    page, 
    Wrappers.lambdaQuery(OpSubscribeVersion.class)
            .orderByDesc(SuperEntity::getCreateTime)
);

问题分析

这个问题的根源在于MyBatis-Plus的条件构造器在处理纯排序场景时的逻辑不够完善。当查询条件中只有排序条件而没有过滤条件时，条件构造器仍然会生成WHERE关键字，但后面没有实际的过滤条件，导致SQL语法错误。

解决方案

对于这种情况，有两种可行的解决方案：

1. 修改XML映射文件
   在XML映射文件中，去掉<where>标签，直接使用${ew.customSqlSegment}：

   select
       a.*,
       b.xxx
   from aa a
   LEFT JOIN bb b on a.b_id = b.id
   ${ew.customSqlSegment}
   

2. 添加一个永真条件
   如果必须保留<where>标签，可以添加一个永真条件：

   Wrappers.lambdaQuery(OpSubscribeVersion.class)
       .eq(OpSubscribeVersion::getId, OpSubscribeVersion::getId)
       .orderByDesc(SuperEntity::getCreateTime)
   

最佳实践

1. 在使用条件构造器时，如果只有排序条件，建议采用第一种方案，直接去掉XML中的<where>标签
2. 对于复杂的查询场景，建议先测试生成的SQL语句是否符合预期
3. 考虑升级到最新版本的MyBatis-Plus，查看是否已经修复了这个问题

总结

MyBatis-Plus的条件构造器虽然强大，但在某些边界情况下仍需要注意使用方式。理解其内部工作原理有助于避免类似的问题。在实际开发中，建议开发者对生成的SQL语句保持关注，特别是在使用排序、分组等操作时。