讲师中心 微信公众号
AI工具推荐 视频效率加速

Spring Boot项目集成Redis后如何优雅地清理缓存?

落雪吖_4109

落雪吖_4109

发布时间:2026-08-26 10:11:08

|

755人浏览过

|

来源于php中文网

原创

应用启动时清理指定缓存键应使用ApplicationRunner配合StringRedisTemplate.delete("key"),避免flushDb()误删全库;需匹配序列化方式,禁用耗时操作以防启动超时。

spring boot项目集成redis后如何优雅地清理缓存?

启动时清理指定缓存键

如果只是想在应用启动后立刻删掉几个已知的缓存键(比如 userCache、configCache),用 ApplicationRunner 最直接可靠:

  • 必须用 StringRedisTemplate 或 RedisTemplate 的 delete 方法,不能用 flushDb() —— 后者会清空整个 DB,连其他服务共用的缓存也一并干掉
  • StringRedisTemplate.delete("key") 只能删字符串类型键;若缓存是对象序列化存的(比如用 RedisTemplate<string object></string>),得用对应类型的 RedisTemplate 实例,否则可能删不掉或报 SerializationException
  • 别在 run() 里写耗时操作(比如遍历大量 key),否则会拖慢启动,甚至触发 Spring Boot 的启动超时(默认 60 秒)

运行时批量删除匹配前缀的缓存

日常运维中更常见的是按业务前缀清理,比如删掉所有以 user: 开头的缓存,而不是全库扫荡:

Redis Skill - 高性能缓存管理
Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载
  • 用 redisTemplate.keys("user:*") 获取匹配 key 列表,再逐个 delete —— 注意:该方法在 Redis 4.0+ 且数据量大时会阻塞主线程,生产环境慎用
  • 更稳妥的做法是改用 redisTemplate.getConnectionFactory().getConnection().scan(...) 配合游标分批扫描,避免单次请求压垮 Redis
  • 确保你存缓存时用的是同一个 RedisTemplate 实例(比如都用 RedisTemplate<string object></string>),否则 keys() 可能查不到某些 key —— StringRedisTemplate 和 RedisTemplate 序列化方式不同,key 名实际存储格式不一致

清空整个 Redis 数据库的风险与替代方案

直接执行 flushDb() 看似简单,但实际非常危险:

  • redisTemplate.getConnectionFactory().getConnection().flushDb() 是最接近原生命令的调用,但它不区分命名空间,删的是当前 DB 下全部数据
  • 如果你的应用和别的服务共享一个 Redis 实例(哪怕只用 DB 0),这个操作等于给所有人“断电”
  • 真正需要全清的场景(如测试环境重置),优先考虑换用独立 Redis 实例,或改用 FLUSHALL 前先确认连接池指向的是隔离环境
  • 开发阶段可加开关控制:比如配置项 redis.clear-on-start=false,默认关闭,上线前人工确认再打开

缓存清理逻辑该放在哪一层?

别把清理逻辑散落在 Controller 里,容易失控:

  • 高频、确定性清理(如更新用户信息后删 user:{id})应封装进 Service 方法,配合 @CacheEvict 注解自动触发
  • 低频、管理型操作(如后台手动清缓存)建议单独建 CacheAdminService,统一处理前缀匹配、分页扫描、日志记录
  • 绝对不要在实体类或 DTO 里写 redisTemplate.delete(...) —— 缓存操作和领域模型耦合,后续换缓存中间件时会哭
  • 如果用了 Spring Cache 抽象(@Cacheable 等),清理优先走 CacheManager.getCache("xxx").clear(),它会适配底层实现,比直连 Redis 模板更安全
真正麻烦的不是“怎么删”,而是删完之后没人知道删了哪些、为什么删、有没有漏删或误删。线上清理操作最好带上下文日志(比如 “by admin@2026-07-13, reason=‘config reload’”),并确保清理动作本身可幂等、可回溯。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2151

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

397

2026.01.26

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4069

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3575

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

6332

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

603

2024.04.07

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

716

2024.04.07

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5762

2024.04.07

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

20

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn