展开菜单
首页 精品内容 本月促销 装机必备 Windows PDF教程 macOS软件 IOS软件 Android AI 专题
全部分类

当前位置:

首页 > 编程开发 > 基于Redis的MybatisPlus二级缓存解决方案

基于Redis的MybatisPlus二级缓存解决方案

在 MyBatis-Plus 中接入 Redis 作为二级缓存,关键其实就两个点:一是把 RedisTemplate 的序列化方式配对,二是搞定 MyBatis 的 Cache 接口实现。这里有个小坑要注意——MyBatis 的 Cache 实现类不受 Spring 容器直接管理,所以得想个办法让它

本文目录

    在 MyBatis-Plus 中接入 Redis 作为二级缓存,关键其实就两个点:一是把 RedisTemplate 的序列化方式配对,二是搞定 MyBatis 的 Cache 接口实现。这里有个小坑要注意——MyBatis 的 Cache 实现类不受 Spring 容器直接管理,所以得想个办法让它可以拿到 RedisTemplate。

    基于Redis的MybatisPlus二级缓存解决方案

    下面直接上配置和代码,一步步说清楚。

    1. 引入依赖

    先把 MyBatis-Plus 和 Spring Data Redis 的依赖加进来:

    
        com.baomidou
        mybatis-plus-boot-starter
        3.5.3.1 
    
    
        org.springframework.boot
        spring-boot-starter-data-redis
    
    
    
        cn.hutool
        hutool-all
        5.8.22
    

    2. 配置 RedisTemplate (关键步骤)

    MyBatis 缓存的对象必须可序列化,这里推荐用 JSON 序列化,比如 Jackson。相比 JDK 默认序列化,JSON 更节省空间,可读性也更好。

    import com.fasterxml.jackson.annotation.JsonAutoDetect;
    import com.fasterxml.jackson.annotation.PropertyAccessor;
    import com.fasterxml.jackson.databind.ObjectMapper;
    import com.fasterxml.jackson.databind.jsontype.impl.LaissezFaireSubTypeValidator;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.data.redis.connection.RedisConnectionFactory;
    import org.springframework.data.redis.core.RedisTemplate;
    import org.springframework.data.redis.serializer.Jackson2JsonRedisSerializer;
    import org.springframework.data.redis.serializer.StringRedisSerializer;
    @Configuration
    public class RedisConfig {
        @Bean
        public RedisTemplate redisTemplate(RedisConnectionFactory connectionFactory) {
            RedisTemplate template = new RedisTemplate<>();
            template.setConnectionFactory(connectionFactory);
            // 使用 String 序列化 Key
            StringRedisSerializer stringSerializer = new StringRedisSerializer();
            template.setKeySerializer(stringSerializer);
            template.setHashKeySerializer(stringSerializer);
            // 使用 Jackson 序列化 Value
            Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer<>(Object.class);
            ObjectMapper om = new ObjectMapper();
            om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
            // 解决 java.util.Date 等类型序列化问题,并启用默认类型信息以支持多态
            om.activateDefaultTyping(LaissezFaireSubTypeValidator.instance, ObjectMapper.DefaultTyping.NON_FINAL);
            jackson2JsonRedisSerializer.setObjectMapper(om);
            template.setValueSerializer(jackson2JsonRedisSerializer);
            template.setHashValueSerializer(jackson2JsonRedisSerializer);
            template.afterPropertiesSet();
            return template;
        }
    }
    
    

    3. 实现 MyBatis Cache 接口

    接下来写一个自定义类,实现 org.apache.ibatis.cache.Cache 接口。注意,这个类是由 MyBatis 创建的,不是 Spring,所以不能直接用 @Autowired,得通过 ApplicationContext 拿到 RedisTemplate。

    方案 A:使用 Hutool 的 SpringUtil(推荐,代码更简洁)

    import cn.hutool.extra.spring.SpringUtil;
    import lombok.extern.slf4j.Slf4j;
    import org.apache.ibatis.cache.Cache;
    import org.springframework.data.redis.core.RedisTemplate;
    import org.springframework.data.redis.core.StringRedisTemplate;
    import java.util.concurrent.locks.ReadWriteLock;
    import java.util.concurrent.locks.ReentrantReadWriteLock;
    @Slf4j
    public class MybatisRedisCache implements Cache {
        private final ReadWriteLock readWriteLock = new ReentrantReadWriteLock();
        private final String id;
        private RedisTemplate redisTemplate;
        // 缓存过期时间(分钟),可根据业务调整
        private static final long EXPIRE_TIME_IN_MINUTES = 30;
        public MybatisRedisCache(String id) {
            if (id == null) {
                throw new IllegalArgumentException("Cache instances require an ID");
            }
            this.id = id;
        }
        @Override
        public String getId() {
            return this.id;
        }
        @Override
        public void putObject(Object key, Object value) {
            getRedisTemplate().opsForHash().put(getId(), key.toString(), value);
            log.debug("Put query result to redis: key={}", key);
        }
        @Override
        public Object getObject(Object key) {
            log.debug("Get cached query result from redis: key={}", key);
            return getRedisTemplate().opsForHash().get(getId(), key.toString());
        }
        @Override
        public Object removeObject(Object key) {
            log.debug("Remove cached query result from redis: key={}", key);
            return getRedisTemplate().opsForHash().delete(getId(), key.toString());
        }
        @Override
        public void clear() {
            log.debug("Clear all cached query results from redis for namespace: {}", getId());
            getRedisTemplate().delete(getId());
        }
        @Override
        public int getSize() {
            Long size = getRedisTemplate().opsForHash().size(getId());
            return size == null ? 0 : size.intValue();
        }
        @Override
        public ReadWriteLock getReadWriteLock() {
            return readWriteLock;
        }
        private RedisTemplate getRedisTemplate() {
            if (redisTemplate == null) {
                // 从 Spring 容器中获取 RedisTemplate
                redisTemplate = SpringUtil.getBean("redisTemplate");
            }
            return redisTemplate;
        }
    }

    方案 B:使用静态 ApplicationContext 持有者(如果不使用 Hutool)

    如果不依赖 Hutool,那就写一个 SpringContextHolder 类,实现 ApplicationContextAware 接口来静态持有 Bean。然后在 MybatisRedisCache 中调用 SpringContextHolder.getBean("redisTemplate") 即可。

    4. 开启二级缓存

    全局配置 (application.yml)

    mybatis-plus:
      configuration:
        cache-enabled: true # 全局开启二级缓存
        # 其他配置...

    Mapper 级别配置

    在具体的 Mapper 接口或 XML 中指定使用刚才写的 Redis 缓存。

    方式一:注解方式(推荐)

    import com.baomidou.mybatisplus.core.mapper.BaseMapper;
    import org.apache.ibatis.annotations.CacheNamespace;
    @CacheNamespace(implementation = MybatisRedisCache.class)
    public interface UserMapper extends BaseMapper {
        // 查询方法
    }

    方式二:XML 方式

    在对应的 UserMapper.xml 里加这么一段:

    
        
        
        
        
    

    5. 注意事项

    1. 实体类序列化:所有要存入缓存的实体类(比如 User)必须实现 Serializable 接口,不然 JSON 序列化可能会翻车。
    2. 缓存一致性:MyBatis 二级缓存默认在 insert/update/delete 操作后会清空该 Namespace 下的所有缓存。在分布式高并发场景下,这种行为可能不够精细。如果业务对缓存一致性要求高,可以考虑在服务层用 Spring Cache(比如 @Cacheable)来替代 MyBatis 二级缓存,拿到的控制粒度会更细。
    3. Key 的设计:上面的示例用了 opsForHash,把同一个 Mapper Namespace 下的缓存项都放在一个 Hash 里,Key 是查询条件的哈希或字符串。这样做方便管理和清理特定 Mapper 的缓存。
    4. 一级缓存干扰:在 Spring 集成环境下,MyBatis 的一级缓存(SqlSession 级别)因为 SqlSession 生命周期受限,效果有限。真正跨 SqlSession 共享缓存得靠二级缓存。所以,确保 cache-enabled: true 已经配好,这是关键。
    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    精品专题 更多
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    macOS软件

    正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

    IOS软件

    正软商城iOS软件专区,精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用,提供功能介绍、适用设备、系统要求和正版获取方式等信息。

    AI

    正软商城AI软件专区,汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具,提供功能介绍、适用平台、收费方式及正版购买信息。

    Mac软件 更多
    Aperty macOS版
    Aperty macOS版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw macOS版
    AionClaw macOS版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy macOS版
    Loomy macOS版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

    AirBuddy 3 macOS版
    AirBuddy 3 macOS版

    AirBuddy 3 是面向 macOS 的蓝牙外设增强工具,可集中查看 AirPods、Beats 与苹果设备电量,提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。

    AirServer macOS版
    AirServer macOS版

    AirServer macOS版可把 Mac 转换为无线投屏接收端,通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面,并支持多设备同时连接、高清镜像及会话录制,适合家庭娱乐、课堂教学、会议演示和应用展示。

    AnyDesk macOS版
    AnyDesk macOS版

    AnyDesk macOS版是一款适用于远程办公、设备维护和客户支持的远程桌面工具,可连接并操作异地计算机,支持文件传输、无人值守访问、会话权限控制及跨平台协作。

    WINDOWS 更多
    讯飞绘文 网页版
    讯飞绘文 网页版

    讯飞绘文网页版是科大讯飞推出的AI图文创作与内容运营工具,覆盖热点选题、文章生成、稿件校对、智能配图、排版发布和数据复盘等环节,适合自媒体创作者及内容团队在线使用。

    Maya(Autodesk Maya) Windows版
    Maya(Autodesk Maya) Windows版

    Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件,集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体,

    Aperty Windows版
    Aperty Windows版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw Windows版
    AionClaw Windows版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy Windows版
    Loomy Windows版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

    AirServer Windows版
    AirServer Windows版

    AirServer Windows版可把电脑变成AirPlay、Google Cast和Miracast无线投屏接收端,适合会议演示、课堂教学及家庭大屏分享。发送设备通常无需另装客户端,并可同时接收和智能排列多个镜像会话。

    网站备案号:苏ICP备2026018738号-1 联系邮箱:bd@zhengruan.com

    Copyright ©2018-2026