MyBatis-Plus中重写基础方法的问题解析

问题背景

在使用MyBatis-Plus进行开发时，开发者有时会遇到需要自定义基础CRUD方法的需求。特别是在分页查询等场景下，开发者可能希望通过XML映射文件来重写框架提供的基础方法，以实现更复杂的SQL逻辑。

问题现象

具体到MyBatis-Plus 3.5.7版本，开发者尝试通过mapper.xml文件重写selectMapsPage方法，目的是为了在分页查询中添加JOIN操作。然而实际执行时发现，框架仍然使用了原始的SQL实现，并没有采用XML中定义的SQL内容。

技术分析

MyBatis-Plus方法调用机制

MyBatis-Plus提供了一系列默认的CRUD方法，这些方法大多是通过接口默认方法(default method)实现的。当开发者调用selectMapsPage方法时，实际上调用的是BaseMapper接口中的默认方法。

XML重写原理

在MyBatis中，XML映射文件中定义的SQL会覆盖接口中的方法实现。但是这种覆盖有一定的规则：

1. 必须确保XML中的方法签名与接口方法完全一致
2. 对于默认方法(default method)，需要重写其实际调用的底层方法

问题根源

selectMapsPage方法实际上内部调用了selectMaps方法。因此，如果开发者想要通过XML重写分页查询逻辑，应该重写selectMaps方法而非selectMapsPage方法。

解决方案

正确做法

1. 在mapper.xml文件中定义selectMaps方法
2. 编写包含JOIN操作的SQL语句
3. 确保方法参数和返回值类型与接口定义一致

示例代码

<!-- mapper.xml -->
<select id="selectMaps" resultType="map">
    SELECT a.*, b.other_field 
    FROM main_table a
    LEFT JOIN other_table b ON a.id = b.main_id
    <where>
        ${ew.sqlSegment}
    </where>
</select>

最佳实践

1. 理解框架方法的实现机制，查看源码了解默认方法的调用链
2. 对于分页查询，通常需要重写的是实际执行SQL的方法而非分页包装方法
3. 在XML中重写方法时，保持与接口方法相同的参数和返回值
4. 对于复杂查询，考虑使用QueryWrapper构建动态条件

总结

MyBatis-Plus虽然提供了便捷的CRUD操作，但在需要自定义复杂SQL时，开发者需要理解框架方法的实现机制。通过正确重写底层方法而非包装方法，可以实现灵活的自定义查询逻辑，同时保持框架的便利性。