Spring Boot 3.5.x|Java 17|Standalone Cluster|Maven Central在微服务架构中一个应用连接多个 Redis 实例或集群几乎是常态——订单用 Redis A用户缓存用 Redis BSession 用 Redis Cluster。然而Spring Boot 官方的spring-boot-starter-data-redis只支持配置一个Redis 数据源Standalone 单实例或 Cluster 集群想要接入多个 Redis要么手写一堆Bean配置要么自己封装 Starter。有没有一种方式只需一行依赖 YAML 配置就能自动注册多个RedisTemplatemulti-redis-spring-boot-starter就是为此而生的。 为什么需要这个 Starter痛点一官方 Starter 只支持单个数据源Spring Boot 的RedisAutoConfiguration只创建一个RedisConnectionFactory和一个RedisTemplate支持 Standalone 单实例或 Cluster 集群模式但只能配置一个数据源。当需要同时连接多个 Redis 时比如订单用 Redis A用户用 Redis B必须手动配置多个LettuceConnectionFactory、多个RedisTemplate代码量急剧膨胀。痛点二多 Redis 配置重复且易错每新增一个 Redis 实例就要复制粘贴一套ConnectionFactoryRedisTemplateStringRedisTemplate的 Bean 定义。4 个 Redis 就是 12 个 Bean配置冗长且容易出错。痛点三迁移成本高已有的项目使用官方配置格式spring.data.redis.host/port切换到多 Redis 方案通常意味着要重写所有配置。如果有一种方案兼容官方配置格式零改动迁移呢 核心亮点✨ 1. 一行依赖即开即用dependencygroupIdorg.hongxi/groupIdartifactIdmulti-redis-spring-boot-starter/artifactIdversion1.0.0/version/dependency已发布到Maven Central无需额外配置仓库地址。这意味着任何 Spring Boot 项目加一行依赖就能获得多 Redis 能力。✨ 2. 双模式设计——代码控制 vs 零代码Mode 1Builder RedisCluster 注解适合需要精细控制的场景// 方式 ABuilder 模式手动创建BeanpublicRedisTemplateString,ObjectorderRedisTemplate(RedisTemplateBuilderbuilder){returnbuilder.cluster(order).keySerializer(RedisSerializer.string()).valueSerializer(RedisSerializer.json()).build();}// 方式 BRedisCluster 注解直接注入最简方式ServicepublicclassOrderService{RedisCluster(order)privateRedisTemplateString,ObjectorderRedisTemplate;RedisCluster(order)privateStringRedisTemplateorderStringRedisTemplate;}Mode 2Auto-register 零代码模式适合标准场景只需 YAML 配置自动注册所有 Bean无需写一行 Java 代码spring:data:redis:auto-register:trueclusters:order:host:localhostport:6379user:host:localhostport:6380cache:cluster:nodes:localhost:7001,localhost:7002,localhost:7003自动生成的 BeanorderRedisTemplate、orderStringRedisTemplateuserRedisTemplate、userStringRedisTemplatecacheRedisTemplate、cacheStringRedisTemplate这意味着从 1 个 Redis 扩展到 4 个 Redis只需要加 YAML 配置不改一行代码。✨ 3. 官方配置格式兼容——无缝迁移这是最实用的特性。如果你现有的项目使用官方配置格式# 现有项目配置官方格式spring:data:redis:host:localhostport:6379password:yourpassword引入这个 Starter 后不需要改任何配置。上述配置会自动识别为名为default的集群Bean 命名为defaultRedisTemplate、defaultStringRedisTemplate。当你需要新增 Redis 实例时只需追加配置spring:data:redis:host:localhost# 现有配置不动port:6379clusters:user:# 新增第二个 Redishost:localhostport:6380这意味着从单 Redis 迁移到多 Redis配置零改动渐进式扩展。✨ 4. Standalone Cluster 双模式同一个 Starter同时支持 Standalone 和 Redis Clusterspring:data:redis:auto-register:trueclusters:order:# Standalone 模式host:localhostport:6379cache:# Cluster 模式cluster:nodes:localhost:7001,localhost:7002,localhost:7003max-redirects:3这意味着无论你的 Redis 部署方式是单机还是集群都能统一管理。✨ 5. 读写分离与连接池支持 Lettuce 连接池配置和集群读写分离spring:data:redis:clusters:cache:cluster:nodes:localhost:7001,localhost:7002,localhost:7003read-from:REPLICA_PREFERRED# 优先从副本节点读取lettuce:pool:max-active:16max-idle:8min-idle:2这意味着生产环境的高可用读写分离一行配置搞定。✨ 6. YAML 序列化配置在 Auto-register 模式下可以直接在 YAML 中配置序列化方式spring:data:redis:clusters:order:host:localhostport:6379serializer:key:string# string | json | java | byteArrayvalue:jsonhash-key:stringhash-value:json序列化类型对应实现适用场景javaJdkSerializationRedisSerializer官方默认兼容性最好jsonGenericJackson2JsonRedisSerializer可读性好跨语言stringStringRedisSerializer纯文本场景byteArrayByteArrayRedisSerializer二进制数据️ 架构设计┌─────────────────────────────────────────────────────────┐ │ Spring Boot Application │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ multi-redis-spring-boot-starter │ │ │ │ │ │ │ │ ┌──────────────────────┐ ┌────────────────┐ │ │ │ │ │ MultiRedisAutoConfig │ │ ImportFilter │ │ │ │ │ │ (排除官方单实例配置) │ │ (条件装配) │ │ │ │ │ └──────────┬───────────┘ └────────────────┘ │ │ │ │ │ │ │ │ │ ┌──────────▼───────────────────────────────┐ │ │ │ │ │ MultiRedisRegistrar │ │ │ │ │ │ (ImportBeanDefinitionRegistrar) │ │ │ │ │ │ │ │ │ │ │ │ 解析 spring.data.redis.clusters.* │ │ │ │ │ │ 为每个 cluster 注册: │ │ │ │ │ │ - RedisConnectionFactory │ │ │ │ │ │ - RedisTemplate │ │ │ │ │ │ - StringRedisTemplate │ │ │ │ │ └──────────┬───────────────────────────────┘ │ │ │ └─────────────┼───────────────────────────────────┘ │ │ │ │ │ ┌─────────────▼───────────────────────────────────┐ │ │ │ RedisTemplateBuilder RedisCluster (Mode 1) │ │ │ │ Auto-register Beans (Mode 2) │ │ │ └─────────────┬───────────────────────────────────┘ │ └────────────────┼────────────────────────────────────────┘ │ ┌────────────┼────────────────┐ │ │ │ ┌───▼───┐ ┌────▼────┐ ┌───────▼──────┐ │Redis A│ │Redis B │ │Redis Cluster │ │:6379 │ │:6380 │ │:7001-:7003 │ └───────┘ └─────────┘ └──────────────┘核心设计理念零侵入不修改 Spring Boot 原有行为通过ImportBeanDefinitionRegistrar动态注册 Bean渐进式采用官方配置格式完全兼容新增 Redis 只需追加配置双模式互补Builder 模式适合复杂定制Auto-register 适合标准场景 模块速查表模块说明multi-redis-spring-boot-autoconfigure核心自动配置模块包含所有自动注册逻辑multi-redis-spring-boot-starterStarter 依赖聚合模块引入即用multi-redis-spring-boot-sample示例项目演示 4 个 Redis 目标的完整用法 学习价值对于初中级开发者✅ 理解 Spring Boot Starter 的实现原理✅ 学习ImportBeanDefinitionRegistrar动态注册 Bean 的机制✅ 掌握多 Redis 场景的配置与使用方式对于高级开发者✅ 深入理解AutoConfigurationImportFilter条件装配✅ 学习RedisTemplateBuilder的 Builder 模式设计✅ 掌握 Lettuce 连接池与集群读写分离配置对于架构师✅ 自定义 Starter 的设计模式参考✅ 官方配置兼容的渐进式迁移方案✅ 多 Redis 集群的统一治理思路 快速开始前置要求Java 17Spring Boot 3.5.xRedis 实例Standalone 或 Cluster3 步接入1. 添加依赖dependencygroupIdorg.hongxi/groupIdartifactIdmulti-redis-spring-boot-starter/artifactIdversion1.0.0/version/dependency2. 配置 YAMLspring:data:redis:auto-register:trueclusters:order:host:localhostport:6379user:host:localhostport:63803. 直接注入使用RestControllerpublicclassDemoController{privatefinalRedisTemplateString,ObjectorderRedisTemplate;privatefinalStringRedisTemplateuserStringRedisTemplate;publicDemoController(RedisTemplateString,ObjectorderRedisTemplate,StringRedisTemplateuserStringRedisTemplate){this.orderRedisTemplateorderRedisTemplate;this.userStringRedisTemplateuserStringRedisTemplate;}GetMapping(/demo)publicStringdemo(){// 写入 order RedisorderRedisTemplate.opsForValue().set(order:001,hello);StringorderorderRedisTemplate.opsForValue().get(order:001);// 写入 user RedisuserStringRedisTemplate.opsForValue().set(user:001,world);StringuseruserStringRedisTemplate.opsForValue().get(user:001);returnorderorder, useruser;}} 最佳实践1. 命名规范集群名称建议使用业务含义Bean 会自动以{clusterName}为前缀集群名生成的 BeanorderorderRedisTemplate,orderStringRedisTemplatecachecacheRedisTemplate,cacheStringRedisTemplatedefaultdefaultRedisTemplate官方格式兼容2. 序列化策略新项目推荐key: stringvalue: json可读性好方便调试迁移项目保持value: java官方默认确保与现有数据兼容跨语言场景使用json序列化其他语言可直接读取3. 生产环境配置spring:data:redis:clusters:cache:cluster:nodes:${REDIS_CLUSTER_NODES}# 环境变量注入read-from:REPLICA_PREFERRED# 读写分离lettuce:pool:max-active:16min-idle:4cluster:refresh:adaptive:true# 自适应拓扑刷新 相关链接GitHub: javahongxi/multi-redis-spring-boot-starterMaven Central: org.hongxi:multi-redis-spring-boot-starterSpring Data Redis: Spring 官方文档Lettuce: Lettuce 官方文档Spring Boot: Spring Boot 官方文档 结语multi-redis-spring-boot-starter解决了一个很实际的问题在 Spring Boot 中优雅地管理多个 Redis 连接。从官方配置兼容到零代码自动注册从 Builder 模式到读写分离它覆盖了多 Redis 场景下的核心需求。如果你正在 为项目中多个 Redis 连接配置而头疼 寻找一个零侵入的多 Redis Starter 方案️ 需要从单 Redis 平滑迁移到多 Redis 想学习自定义 Spring Boot Starter 的实现方式Star ⭐ multi-redis-spring-boot-starter让多 Redis 管理变得简单gitclone https://github.com/javahongxi/multi-redis-spring-boot-starter.git© hongxi.org| 打造实用的 Spring Boot 开源组件