大家好我是Java1234_小锋老师。网上很多都是老旧版本的整合开发锋哥整理了下最新版本整合开发的注意点以及新特性用法。一、为什么选这套组合Spring Boot 4 在 2025 年底正式发布底层是 Spring Framework 7默认要求 Java 17对 Jackson 3、Jakarta EE 11 做了统一升级。日常开发里你能明显感受到两点变化启动配置更模块化以及空安全注解JSpecify让 IDE 提示更准。Redis 8 则在性能和新命令上持续发力。配合 Spring Data Redis 4.1以前要自己拼RedisMessageListenerContainer的 Pub/Sub现在可以像写KafkaListener一样写RedisListenerRedis 8.4 新增的 Compare-and-Set、DIGEST 等命令Spring 侧也已经跟上了。一句话总结新项目用 Spring Boot 4 Redis 8开发体验更顺也不用背那么多样板代码。二、整体架构长什么样一个典型的 Spring Boot 4 应用接入 Redis 8可以分成三层来理解层级职责常用组件应用层处理业务请求、发消息、加缓存Controller、Service、Cacheable、RedisListener中间层屏蔽 Redis 协议细节RedisTemplate、RedisCacheManager、Lettuce 连接池存储层真正存数据、跑命令Redis 8 的 String/Hash、Pub/Sub、Stream、JSON 模块业务代码尽量只碰应用层和 Spring 提供的 API别在 Service 里直接拼 Redis 命令字符串——后期换客户端、做单元测试都会轻松很多。三、项目快速搭建3.1 核心依赖parentgroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-parent/artifactIdversion4.1.0/version/parentdependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-data-redis/artifactId/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-cache/artifactId/dependencydependencygroupIdorg.apache.commons/groupIdartifactIdcommons-pool2/artifactId/dependency/dependencies3.2 基础配置spring:data:redis:host:127.0.0.1port:6379password:lettuce:pool:max-active:16max-idle:8min-idle:2max-wait:3000mscache:type:redisredis:time-to-live:30mcache-null-values:false3.3 Redis 连接配置类ConfigurationEnableCachingpublicclassRedisConfig{BeanpublicRedisTemplateString,ObjectredisTemplate(RedisConnectionFactoryfactory){RedisTemplateString,ObjecttemplatenewRedisTemplate();template.setConnectionFactory(factory);template.setKeySerializer(newStringRedisSerializer());template.setValueSerializer(newGenericJacksonJsonRedisSerializer());template.setHashKeySerializer(newStringRedisSerializer());template.setHashValueSerializer(newGenericJacksonJsonRedisSerializer());template.afterPropertiesSet();returntemplate;}}到这里一个能跑起来的基础整合就完成了。下面进入本文重点——新特性怎么用。四、新特性实战 Demo4.1 注解驱动的 Redis 消息监听以前的做法手动创建RedisMessageListenerContainer注册MessageListener代码散在好几个类里。现在的做法加EnableRedisListeners在方法上标RedisListener跟 Kafka 那套几乎一样。配置类ConfigurationEnableRedisListenerspublicclassRedisListenerConfig{BeanpublicRedisMessageListenerContainerredisMessageListenerContainer(RedisConnectionFactoryconnectionFactory){RedisMessageListenerContainercontainernewRedisMessageListenerContainer();container.setConnectionFactory(connectionFactory);returncontainer;}}消息发送方ServicepublicclassOrderNotifyService{privatefinalRedisMessageSendingTemplateString,StringsendingTemplate;publicOrderNotifyService(RedisMessageSendingTemplateString,StringsendingTemplate){this.sendingTemplatesendingTemplate;}publicvoidnotifyOrderPaid(LongorderId){Stringpayload{\orderId\:orderId,\status\:\PAID\};sendingTemplate.convertAndSend(order-notify,payload);}}消息接收方ComponentpublicclassOrderNotifyListener{privatestaticfinalLoggerlogLoggerFactory.getLogger(OrderNotifyListener.class);RedisListener(topicorder-notify)publicvoidonOrderPaid(Stringmessage){log.info(收到订单通知: {},message);// 这里写你的业务逻辑比如更新本地状态、发站内信等}}小提示如果消息体是 JSON可以在RedisListener(consumes application/json)里声明类型框架会自动选对应的转换器。4.2 Compare-and-Set乐观锁不用写 Lua 了分布式场景里经常遇到这种需求「只有当 key 当前值等于 A 时才改成 B」。以前很多人写 Lua 脚本来保证原子性。Redis 8.4 提供了 Compare-and-SetCAS和 Compare-and-DeleteCADSpring Data Redis 4.1 在RedisTemplate层已经封装好了。场景示例防止优惠券被重复领取ServicepublicclassCouponService{privatefinalStringRedisTemplatestringRedisTemplate;publicCouponService(StringRedisTemplatestringRedisTemplate){this.stringRedisTemplatestringRedisTemplate;}/** * 只有券状态为 AVAILABLE 时才改成 CLAIMED */publicbooleanclaimCoupon(StringcouponId,StringuserId){Stringkeycoupon:couponId;BooleansuccessstringRedisTemplate.opsForValue().setIfPresent(key,CLAIMED:userId,Duration.ofHours(24));returnBoolean.TRUE.equals(success);}/** * 只有值匹配时才删除用于 token 失效场景 */publicbooleaninvalidateToken(Stringtoken){Stringkeytoken:token;returnBoolean.TRUE.equals(stringRedisTemplate.delete(key,token));}}CAS 适合读多写少、冲突概率不高的场景。如果同一 key 并发极高还是建议上 Redisson 分布式锁或数据库乐观锁字段。4.3 DIGEST 命令更快的哈希计算Redis 8 新增的DIGEST命令用 XXH3 算法算哈希比自己在应用层算 MD5/SHA 再存进去更省事也更适合做大文件或长字符串的指纹比对。ServicepublicclassFileDigestService{privatefinalRedisTemplateString,StringredisTemplate;publicFileDigestService(RedisTemplateString,StringredisTemplate){this.redisTemplateredisTemplate;}publicStringcomputeDigest(Stringcontent){// 调用 Redis 8 DIGEST 命令服务端计算 XXH3 哈希returnredisTemplate.execute((RedisCallbackString)connection-connection.digest(content.getBytes(StandardCharsets.UTF_8)));}publicbooleanisDuplicate(Stringcontent){StringdigestcomputeDigest(content);Stringkeyfile:digest:digest;BooleanisNewredisTemplate.opsForValue().setIfAbsent(key,1,Duration.ofDays(7));return!Boolean.TRUE.equals(isNew);// true 表示重复文件}}典型用途上传去重、缓存键生成、数据一致性抽检。4.4 Duration 过期 API告别 TimeUnit 混乱Spring Data Redis 4.1 开始推荐用Duration和Expiration替代TimeUnit参数。语义更清晰也不容易把「秒」和「毫秒」搞反。// 旧写法已标记过时// redisTemplate.expire(user:1001, 30, TimeUnit.MINUTES);// 新写法推荐redisTemplate.expire(user:1001,Duration.ofMinutes(30));// 带过期条件的 SETredisTemplate.opsForValue().set(session:abc,userInfo,Expiration.from(Duration.ofHours(2)));团队里如果有 Code Review 规范可以直接约定新代码一律用 Duration老代码迁移时顺手改。4.5 一键清空缓存resetCaches运维或测试环境经常需要「把所有缓存清掉」。以前要么FLUSHDB太狠要么自己维护 key 列表。Spring Data Redis 4.1 给CacheManager加了resetCaches()会按缓存区域批量清理比全库 flush 安全。RestControllerRequestMapping(/admin/cache)publicclassCacheAdminController{privatefinalCacheManagercacheManager;publicCacheAdminController(CacheManagercacheManager){this.cacheManagercacheManager;}PostMapping(/reset)publicStringresetAllCaches(){if(cacheManagerinstanceofRedisCacheManagerredisCacheManager){redisCacheManager.resetCaches();return缓存已重置;}return当前 CacheManager 不支持 resetCaches;}}注意生产环境要给这个接口加权限控制别裸奔在线上。五、缓存使用最佳实践结合上图几条实战经验1. 合理设置 TTL缓存不是越久越好。热点数据 5~30 分钟配置类数据 1~24 小时按业务容忍的「脏读时间」来定。2. 注意缓存穿透查询不存在的数据时别把null也缓存了除非你能接受。配置里cache-null-values: false是第一步还可以对空结果缓存一个短 TTL 的占位值。3. 更新策略选对场景推荐做法读多写少Cacheable 过期自动失效写后立即读CachePut或先更新 DB 再删缓存数据一致性要求高先更新 DB再CacheEvict删缓存4. 示例商品详情缓存ServicepublicclassProductService{Cacheable(valueproduct,key#id)publicProductgetById(Longid){returnproductMapper.selectById(id);}CacheEvict(valueproduct,key#product.id)publicvoidupdate(Productproduct){productMapper.updateById(product);}}六、生产环境配置建议不需要一上来就搞集群但下面几条建议尽早落地spring:data:redis:timeout:3sconnect-timeout:3slettuce:pool:max-active:32max-idle:16min-idle:4shutdown-timeout:200ms连接池Lettuce 默认共享连接高并发场景务必开 commons-pool2按 QPS 调整max-active。序列化生产环境统一用 JSON 序列化Jackson方便排查问题时用redis-cli直接看内容。监控Spring Boot Actuator 配合spring-boot-starter-data-redis的健康检查能及时发现 Redis 连不上的情况。Key 规范建议统一前缀比如app:module:biz:id避免多服务共用一个 Redis 实例时互相踩 key。七、最后锋哥小结下哈Spring Boot 4 和 Redis 8 凑在一起并不是「版本号 1」那么简单。实际开发中值得优先用上的几点RedisListener—— Pub/Sub 监听声明式写法代码量明显减少CAS / CAD—— 乐观锁、token 失效等场景不用再手写 LuaDIGEST—— 哈希计算交给 Redis应用层更轻Duration API—— 过期时间写法统一减少低级 bugresetCaches—— 缓存清理更可控告别粗暴FLUSHDB建议新项目直接以Spring Boot 4.1 Spring Data Redis 4.1 Redis 8.4作为基线。老项目如果还在 Boot 3.x可以先把 Redis 客户端升上去再规划 Boot 4 迁移——两条线并行风险更小。