Mybatis 动态 SQL 与缓存机制：2025 版官方手册核心功能解读

? Mybatis 动态 SQL 与缓存机制：2025 版官方手册核心功能解读

? 动态 SQL：灵活构建查询的利器

Mybatis 的动态 SQL 功能在 2025 版官方手册中进一步优化，让开发者能更轻松地应对复杂查询场景。它允许根据不同条件动态拼接 SQL 语句，避免了手动拼接字符串的麻烦，同时提高了代码的可维护性。

动态 SQL 的核心是一系列标签，比如 if、where、trim、choose、foreach 等。if 标签用于简单的条件判断，只有当条件满足时，才会将标签内的 SQL 片段添加到最终语句中。例如，在查询用户信息时，可以根据传入的参数动态添加条件：

xml

<select id="selectUser" resultType="User">
  SELECT * FROM users
  <where>
    <if test="id != null">
      id = #{id}
    if>
    <if test="name != null">
      AND name = #{name}
    if>
  where>
select>

where 标签会自动处理 WHERE 关键字和多余的 AND 或 OR，确保生成的 SQL 语句语法正确。而 trim 标签则更灵活，可以自定义去除 SQL 前后的多余字符，比如在 WHERE 子句中去掉开头的 AND：

xml

<trim prefix="WHERE" prefixOverrides="AND | OR">
  <if test="id != null">
    id = #{id} AND
  if>
  <if test="name != null">
    name = #{name}
  if>
trim>

对于批量操作，foreach 标签非常实用。它可以循环遍历集合，生成 IN 子句或批量插入语句。例如，批量删除用户时：

xml

<delete id="deleteUsers">
  DELETE FROM users
  WHERE id IN
  <foreach collection="ids" item="id" open="(" separator="," close=")">
    #{id}
  foreach>
delete>

2025 版还对动态 SQL 的条件判断进行了优化，支持更复杂的 OGNL 表达式，让开发者能更灵活地控制 SQL 生成逻辑。比如，可以在 if 标签中使用逻辑运算符组合多个条件：

xml

<if test="id != null and name != null">
  id = #{id} AND name = #{name}
if>

? 缓存机制：提升性能的关键

Mybatis 的缓存机制分为一级缓存和二级缓存，两者协同工作以减少数据库访问次数，提升系统性能。

一级缓存是 SqlSession 级别的缓存，默认开启。在同一个 SqlSession 中执行相同的查询时，结果会直接从缓存中获取，无需再次访问数据库。例如，在事务中多次查询相同数据：

java

@Transactional
public void processOrder(int userId) {
  User user = userMapper.findById(userId); // 第一次查库
  // ...业务处理...
  User cacheUser = userMapper.findById(userId); // 从一级缓存获取
}

不过，一级缓存的生命周期与 SqlSession 绑定，当 SqlSession 关闭或提交事务时，缓存会被清空。此外，执行增删改操作也会触发一级缓存的刷新。

二级缓存是 Mapper 级别的缓存，需要手动配置开启。它可以跨多个 SqlSession 共享数据，适合缓存更新频率低的静态数据。在 Mapper XML 文件中添加标签即可启用二级缓存：

xml

<mapper namespace="com.example.UserMapper">
  <cache eviction="LRU" flushInterval="60000" size="512" readOnly="true"/>
  <select id="findAllRegions" resultType="Region">
    SELECT * FROM regions
  select>
mapper>

二级缓存支持多种回收策略，如 LRU（最近最少使用）、FIFO（先进先出）、SOFT（软引用）和 WEAK（弱引用）。可以根据业务需求选择合适的策略。例如，LRU 策略会优先移除最长时间未被使用的数据，适合访问模式不确定的场景。

2025 版对缓存机制进行了性能优化，特别是在分布式环境下的表现。默认情况下，二级缓存是本地缓存，无法跨节点共享。为了解决这个问题，可以整合第三方缓存如 Redis。通过配置 type 属性，将二级缓存替换为 Redis 实现：

xml

<cache type="org.mybatis.caches.redis.RedisCache"/>

这样，缓存数据会存储在 Redis 中，实现跨节点共享，同时还能利用 Redis 的持久化和高可用特性。

?️ 最佳实践与常见问题

在使用动态 SQL 和缓存机制时，有一些最佳实践和常见问题需要注意。

对于动态 SQL，要避免过度使用标签导致代码复杂。优先使用简单的条件判断，必要时再组合多个标签。同时，要注意 SQL 注入问题，始终使用参数绑定（#{}）而不是字符串拼接。

在缓存配置方面，要根据数据的更新频率和一致性要求选择合适的缓存策略。对于读多写少的数据，启用二级缓存可以显著提升性能；但对于实时性要求高的数据，应禁用缓存或设置较短的刷新间隔。此外，分布式环境下要使用集中式缓存如 Redis，避免节点间数据不一致。

常见问题如脏读和缓存穿透也需要妥善处理。脏读通常是由于关联表更新导致缓存数据不一致，可以通过手动清除关联缓存或使用分布式事务来解决。缓存穿透则是由于频繁查询不存在的数据导致数据库压力增大，解决方案包括缓存空值或使用布隆过滤器。

? 总结

Mybatis 的动态 SQL 和缓存机制是提升数据库操作效率的重要工具。2025 版官方手册进一步优化了这些功能，使其更灵活、更高效。通过合理使用动态 SQL 标签和缓存策略，可以显著减少数据库访问次数，提升系统性能。在实际应用中，要根据业务需求选择合适的配置，并注意解决常见问题，以充分发挥 Mybatis 的优势。

该文章由dudu123.com嘟嘟 ai 导航整理，嘟嘟 AI 导航汇集全网优质网址资源和最新优质 AI 工具。

正文

Mybatis 动态 SQL 与缓存机制：2025 版官方手册核心功能解读