摘要：作为后端开发，你有没有这样的经历？项目里要同时用 Redis 存用户会话、缓存业务数据、存储排行榜，不同模块的数据混在一个数据库里，key 命名冲突不说，排查问题时翻日志翻到眼花；想分开用多个 db 吧，Spring Boot 默认的 RedisTemplat
作为后端开发，你有没有这样的经历？项目里要同时用 Redis 存用户会话、缓存业务数据、存储排行榜，不同模块的数据混在一个数据库里，key 命名冲突不说，排查问题时翻日志翻到眼花；想分开用多个 db 吧，Spring Boot 默认的 RedisTemplate 又只能绑定一个数据源，手动切换配置又麻烦又容易出错，上线前还得反复测试生怕踩坑？
如果你也遇到过这种 “想分库又怕麻烦” 的窘境，那这篇文章一定要看到最后 —— 今天手把手教你用 3 步实现 Spring Boot 下 Redis 多数据库无缝切换，配置简单、代码复用率高，还附带实战避坑技巧，亲测在 3 个生产项目中稳定运行，帮团队节省了大量调试时间！
在聊具体实现之前，先说说为啥我们需要多 Redis 数据库配置。作为后端开发，日常工作中难免遇到这些场景：
数据隔离需求：用户登录会话（session）、商品缓存、限流计数器等不同类型的数据，分开存储能避免 key 冲突，比如 “user:1001” 既可能是用户信息缓存，也可能是用户会话 key，分库后直接用 db0 存会话、db1 存缓存，彻底杜绝冲突；权限控制更灵活：不同模块的开发人员只能操作对应数据库，比如运维人员可查看 db2 的监控数据，但不能修改 db0 的核心业务缓存，降低误操作风险；资源隔离提升稳定性：当某个数据库因大量写入导致性能下降时，不会影响其他数据库的正常使用，比如排行榜模块的高频更新不会拖慢用户会话查询；方便数据备份与清理：不同生命周期的数据可独立备份，比如临时缓存数据存在 db3，清理时直接 flushdb 即可，无需担心误删核心数据。而 Spring Boot 自带的 RedisAutoConfiguration 默认只支持单数据源配置，若想使用多个数据库，要么创建多个 RedisTemplate 实例（代码冗余），要么手动修改连接参数（线程不安全），这也是很多开发者觉得 “多库切换麻烦” 的核心原因。
接下来进入核心实战环节，全程基于 Spring Boot 2.7.x + Redis 6.x 版本，步骤清晰无废话，新手也能快速上手。
首先在 pom.xml 中引入 Redis 核心依赖（若已引入可跳过）：
org.springframework.bootspring-boot-starter-data-redisorg.apache.commonscommons-pool2然后在 application.yml 中配置多 Redis 数据库信息，这里以 3 个数据库为例（可根据需求增减）：
spring: redis: # 公共配置（超时时间、连接池等） timeout: 3000ms lettuce: pool: max-active: 8 max-idle: 8 min-idle: 2 # 多数据库配置（db0-会话存储，db1-业务缓存，db2-计数器） databases: db0: host: 127.0.0.1 port: 6379 password: 123456 database: 0 db1: host: 127.0.0.1 port: 6379 password: 123456 database: 1 db2: host: 127.0.0.1 port: 6379 password: 123456 database: 2这一步是关键！通过自定义 Redis 配置类，创建多个 RedisTemplate 实例，并利用 ThreadLocal 实现线程安全的数据库切换。
首先创建 Redis 常量类，定义数据库类型：
/** * Redis 数据库类型常量 */public enum RedisDbType { SESSION_DB(0, "会话存储数据库"), BUSINESS_DB(1, "业务缓存数据库"), COUNTER_DB(2, "计数器数据库"); private final int dbIndex; private final String desc; // 构造方法、getter 省略}然后创建 Redis 配置类，初始化多个数据源：
import org.springframework.boot.context.properties.ConfigurationProperties;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.data.redis.connection.RedisConnectionFactory;import org.springframework.data.redis.connection.lettuce.LettuceConnectionFactory;import org.springframework.data.redis.core.RedisTemplate;import org.springframework.data.redis.serializer.StringRedisSerializer;import java.util.HashMap;import java.util.Map;/** * Redis 多数据库配置类 */@Configurationpublic class RedisMultiDbConfig { // 绑定 db0 配置 @Bean @ConfigurationProperties(prefix = "spring.redis.databases.db0") public RedisProperties db0Properties { return new RedisProperties; } // 绑定 db1 配置 @Bean @ConfigurationProperties(prefix = "spring.redis.databases.db1") public RedisProperties db1Properties { return new RedisProperties; } // 绑定 db2 配置 @Bean @ConfigurationProperties(prefix = "spring.redis.databases.db2") public RedisProperties db2Properties { return new RedisProperties; } // 创建 db0 连接工厂 @Bean public RedisConnectionFactory db0ConnectionFactory(RedisProperties db0Properties) { return createConnectionFactory(db0Properties); } // 创建 db1 连接工厂 @Bean public RedisConnectionFactory db1ConnectionFactory(RedisProperties db1Properties) { return createConnectionFactory(db1Properties); } // 创建 db2 连接工厂 @Bean public RedisConnectionFactory db2ConnectionFactory(RedisProperties db2Properties) { return createConnectionFactory(db2Properties); } // 初始化 RedisTemplate 映射 @Bean public Map> redisTemplateMap( RedisConnectionFactory db0ConnectionFactory, RedisConnectionFactory db1ConnectionFactory, RedisConnectionFactory db2ConnectionFactory) { Map> templateMap = new HashMap; templateMap.put(RedisDbType.SESSION_DB, createRedisTemplate(db0ConnectionFactory)); templateMap.put(RedisDbType.BUSINESS_DB, createRedisTemplate(db1ConnectionFactory)); templateMap.put(RedisDbType.COUNTER_DB, createRedisTemplate(db2ConnectionFactory)); return templateMap; } // 通用连接工厂创建方法 private RedisConnectionFactory createConnectionFactory(RedisProperties properties) { org.springframework.data.redis.connection.RedisStandaloneConfiguration config = new org.springframework.data.redis.connection.RedisStandaloneConfiguration; config.setHostName(properties.getHost); config.setPort(properties.getPort); config.setPassword(properties.getPassword); config.setDatabase(properties.getDatabase); return new LettuceConnectionFactory(config); } // 通用 RedisTemplate 创建方法（设置序列化方式，避免乱码） private RedisTemplatecreateRedisTemplate(RedisConnectionFactory factory) { RedisTemplatetemplate = new RedisTemplate; template.setConnectionFactory(factory); // 设置 key 序列化器 template.setKeySerializer(new StringRedisSerializer); // 设置 value 序列化器（可替换为 FastJson2JsonRedisSerializer 等） template.setValueSerializer(new StringRedisSerializer); template.afterPropertiesSet; return template; } // 自定义 RedisProperties 类，绑定配置文件 public static class RedisProperties { private String host; private int port; private String password; private int database; // getter、setter 省略 }}最后创建 Redis 工具类，实现动态切换：
import org.springframework.data.redis.core.RedisTemplate;import org.springframework.stereotype.Component;import javax.annotation.Resource;import java.util.Map;/** * Redis 多库操作工具类 */@Componentpublic class RedisMultiDbUtil { // 存储当前线程使用的数据库类型 private static final ThreadLocalCURRENT_DB = new ThreadLocal; @Resource private Map> redisTemplateMap; // 切换数据库 public void switchDb(RedisDbType dbType) { CURRENT_DB.set(dbType); } // 获取当前数据库的 RedisTemplate private RedisTemplategetCurrentRedisTemplate { RedisDbType dbType = CURRENT_DB.get; if (dbType == null) { // 默认使用 db0 dbType = RedisDbType.SESSION_DB; CURRENT_DB.set(dbType); } return redisTemplateMap.get(dbType); } // 以下是常用操作方法（示例） public void set(String key, Object value) { getCurrentRedisTemplate.opsForValue.set(key, value); } public Object get(String key) { return getCurrentRedisTemplate.opsForValue.get(key); } // 其他方法（hash、list、set 等）可按需扩展}配置完成后，在业务代码中直接注入工具类，调用 switchDb 方法即可切换数据库，示例如下：
import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RestController;import javax.annotation.Resource;@RestControllerpublic class RedisMultiDbDemoController { @Resource private RedisMultiDbUtil redisMultiDbUtil; @GetMapping("/testMultiDb") public String testMultiDb { // 1. 使用会话数据库（db0）存储用户会话 redisMultiDbUtil.switchDb(RedisDbType.SESSION_DB); redisMultiDbUtil.set("session:user:1001", "login_success"); // 2. 切换到业务缓存数据库（db1）存储商品信息 redisMultiDbUtil.switchDb(RedisDbType.BUSINESS_DB); redisMultiDbUtil.set("cache:goods:2001", "iPhone 15 Pro"); // 3. 切换到计数器数据库（db2）存储访问次数 redisMultiDbUtil.switchDb(RedisDbType.COUNTER_DB); redisMultiDbUtil.set("counter:visit:index", 10086); // 验证数据（不同库的 key 互不干扰） redisMultiDbUtil.switchDb(RedisDbType.SESSION_DB); String session = (String) redisMultiDbUtil.get("session:user:1001"); redisMultiDbUtil.switchDb(RedisDbType.BUSINESS_DB); String goods = (String) redisMultiDbUtil.get("cache:goods:2001"); return "会话数据：" + session + "，商品缓存：" + goods + "，访问次数：" + redisMultiDbUtil.get("counter:visit:index"); }}启动项目后访问 http://localhost:8080/testMultiDb，即可看到不同数据库的数据正常存储和读取，key 互不冲突，切换过程丝滑无卡顿！
序列化方式统一：不同 RedisTemplate 的序列化器必须一致，否则会出现 “存得进去、取不出来” 的乱码问题，推荐全局使用 FastJson2JsonRedisSerializer 或 GenericJackson2JsonRedisSerializer；线程安全问题：一定要用 ThreadLocal 存储当前数据库类型，避免多线程环境下切换混乱，比如异步任务中使用时，需在任务开始前切换数据库，结束后清除 ThreadLocal 数据（防止内存泄漏）；连接池配置合理：多数据源会占用更多连接，需根据服务器性能调整 max-active、max-idle 等参数，避免连接池耗尽导致服务阻塞；集群环境适配：若 Redis 是集群模式，需修改连接工厂为 RedisClusterConfiguration，且集群默认不支持多 db（所有数据存在 db0），此时可通过 key 前缀隔离（如 “session:”“cache:”）替代多 db 方案。以上就是 Spring Boot 实现 Redis 多数据库切换的完整方案，从配置到实战再到避坑，全程贴合开发场景，复制代码就能落地使用。
作为后端开发，你在使用 Redis 时还遇到过哪些多数据源相关的问题？比如集群环境下如何实现数据隔离、多库切换的性能优化技巧等，欢迎在评论区分享你的经验；如果这篇文章帮你解决了实际问题，也别忘了点赞、收藏，转发给身边有需要的同事，让更多人少踩坑！
来源：从程序员到架构师
免责声明：本站系转载，并不代表本网赞同其观点和对其真实性负责。如涉及作品内容、版权和其它问题，请在30日内与本站联系，我们将在第一时间删除内容!
