Springboot 集成 mybatis 开启二级缓存（redis）

最新推荐文章于 2025-07-17 10:06:13 发布

原创

最新推荐文章于 2025-07-17 10:06:13 发布 · 7.9k 阅读

31 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #redis #springboot

本文介绍了如何在Springboot项目中集成Mybatis并开启二级缓存，利用Redis作为二级缓存的存储。详细讲解了一级缓存和二级缓存的工作原理，并提供了配置Redis缓存的关键步骤，包括添加依赖、配置文件设置、实体类序列化以及自定义Cache实现。文章还提及了在实践过程中遇到的问题和解决方法，以及参考的相关优秀博客资源。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

首先来了解下mybatis 缓存，mybatis缓存分为一级缓存和二级缓存。一级缓存是默认开启的，无需其他配置操作，二级缓存则需要手动设置开启。

一级缓存原理：

Mybatis的一级缓存是指同一个SqlSession中的操作。一级缓存的作用域是一个SqlSession。
在同一个SqlSession中，执行相同的查询SQL，第一次会去查询数据库，并写到缓存中；第二次直接从缓存中取。当执行SQL时两次查询中间发生了增删改操作，则SqlSession的缓存清空。

在这里插入图片描述

二级缓存原理：

Mybatis的二级缓存是指mapper映射文件。二级缓存是多个sqlSession共享的，其作用域是mapper下的同一个namespace。
在不同的sqlSession中，相同的namespace下，相同的查询sql语句并且参数也相同的情况下，会命中二级缓存。如果调用相同namespace下的mapper映射文件中的增删改SQL，并执行了commit操作。此时会清空该namespace下的二级缓存。

在这里插入图片描述

了解一些基本原理后，我们开始在springboot集成mybatis的情况下，开启二级缓存。

在pom.xml文件中引入mybatis和redis的依赖

        <!--mybatis 依赖包-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
        </dependency>
        <!--mysql-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <!--redis lettuce-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-pool2</artifactId>
        </dependency>

在application.yml文件中配置mybatis相关设置时，开启二级缓存

### mybatis相关配置
mybatis:
  configuration:
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
      #开启MyBatis的二级缓存
      cache-enabled: true
  mapper-locations: classpath*:mappers/*Mapper.xml

### Redis 相关配置
redis:
  host: localhost
  port: 6379
  timeout: 10000
  database: 0
  lettuce:
    pool:
      max-active: 8
      max-wait: -1
      max-idle: 8
      min-idle: 0

实体类实现序列化

我们采用的redis序列化方式是默认的jdk序列化。所以数据库的查询对象（比如Student类）需要实现Serializable接口。

public class Student implements Serializable {
   
   
    //采用的redis序列化方式是默认的jdk序列化。所以数据库的查询对象实体需要实现Serializable接口。
    private static final long serialVersionUID = 1L;

    private int id;
    private String name;
    private int age;
    private String position;

    public int getId() {
   
   
        return id;
    }
    public void setId(int id) {
   
   
        this.id = id;
    }
    public String getName() {
   
   
        return name;