Java 后端 / 系统课时

优化MyBatis查询

优化MyBatis查询

本篇解决 MyBatis 查询中 SQL 设计、结果映射和动态 SQL 带来的性能问题,通过规范 Mapper 编写和执行验证,让查询更稳定、更容易优化。

学习目标

  • 掌握 MyBatis Mapper 查询优化方法
  • 理解结果映射和动态 SQL 对性能的影响
  • 能通过日志和 SQL 执行结果验证优化效果

合理设计Mapper查询

MyBatis 性能优化首先取决于 SQL 设计。Mapper 不应为了通用复用而返回无关字段,也不应让一个查询覆盖多个业务场景。高频接口通常应根据需求定义明确的返回结构。

java
@Mapper
public interface UserMapper {
    User findById(Long id);
}

预期输出

text
Mapper 方法成功绑定 SQL,并返回对应 User 对象。

实际项目中应结合 XML 或注解 SQL 定义查询字段,优先返回业务需要的数据,减少数据库读取、网络传输和对象转换成本。

优化结果映射

resultMap 适合处理复杂字段映射关系,但过深的嵌套映射会增加对象组装成本。对于高频查询,应控制关联层级,避免一次加载大量不必要的数据。

xml
<select id="findSimpleUser" resultType="User">
    SELECT id, name
    FROM user_account
    WHERE id = #{id}
</select>

预期结果

text
查询只返回 id 和 name 字段,减少数据传输和映射处理开销。

示例中的 User 为项目中已定义的实体类型,user_account 为实际业务表名,生产环境需要替换为对应数据库对象。

控制动态SQL复杂度

动态 SQL 可以提升查询灵活性,但过多条件拼接会增加 SQL 维护成本,也可能导致执行计划不稳定。常用查询应保持结构清晰,并配合索引设计。

xml
<select id="findActiveUsers" resultType="User">
    SELECT id, name
    FROM user_account
    WHERE status = #{status}
</select>

预期结果

text
数据库执行结构稳定的查询语句,优化器可以更容易复用合适的执行计划。

对于复杂筛选场景,应检查生成后的真实 SQL,而不是只关注 Mapper 文件中的动态标签。

使用日志验证优化效果

查询优化完成后,需要通过实际执行信息验证结果。可以开启 MyBatis SQL 日志,观察 SQL、参数和执行耗时,再结合数据库执行计划判断优化是否有效。

properties
mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

预期输出

text
==>  Preparing: SELECT id, name FROM user_account WHERE status = ?
==> Parameters: active(String)
<==      Total: 20

发现慢查询时,应按照 SQL 执行计划、返回数据量、索引使用情况和 Mapper 设计顺序定位问题,而不是优先调整 MyBatis 配置。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

优化MyBatis查询

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通