如何在Spring Boot中配置Redis集群模式_设置spring.redis.cluster.nodes参数

浅萱吖_9500

浅萱吖_9500

2026-06-14

652人浏览

原创

直接配置spring.redis.cluster.nodes即可连接redis集群,但节点格式必须为host:port(如127.0.0.1:7001),禁用redis://、空格及localhost;需设置spring.redis.cluster.max-redirects(建议等于master数),并删除被忽略的spring.redis.host/port。

如何在spring boot中配置redis集群模式_设置spring.redis.cluster.nodes参数

直接配 spring.redis.cluster.nodes 就能连上集群,但节点列表写错、格式不规范或漏关键配套参数,90% 的连接失败都发生在这里。

节点地址必须用 host:port 格式,不能带 redis:// 或空格

常见错误是复制了其他文档里的示例,比如写成 redis://localhost:7001 或 127.0.0.1 : 7001(中间有空格)。Spring Boot 的 RedisClusterConfiguration 解析器只认纯 host:port 形式:

  • ✅ 正确:127.0.0.1:7001,127.0.0.1:7002,127.0.0.1:7003
  • ❌ 错误:redis://127.0.0.1:7001、127.0.0.1:7001 , 127.0.0.1:7002、localhost:7001(部分 DNS 不稳定环境会解析失败)
  • ⚠️ 注意:所有节点必须是可互相发现的 master 节点(非仅 slave),且集群已通过 redis-cli --cluster create 正确构建并进入 ok 状态

必须配 spring.redis.cluster.max-redirects,否则跨节点操作直接报错

Redis 集群客户端收到 MOVED 或 ASK 重定向响应时,需要知道最多尝试几次。不设这个值,Lettuce 默认为 0,意味着拒绝重定向 —— 表现为 RedisCommandExecutionException: MOVED 或 ASK 异常。

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载
  • 建议值设为集群 master 节点数,例如 6 个 master 就设 spring.redis.cluster.max-redirects=6
  • 该值不是越大越好:超过实际跳转深度会导致无意义等待,超时后仍失败
  • 若用 Jedis(需显式引入 jedis 依赖),它默认支持重定向,但 Spring Boot 2.3+ 默认用 Lettuce,所以这个配置不可省

密码、超时、连接池参数要分清作用域,混用会静默失效

Spring Boot 自动配置对不同客户端使用不同前缀,写错前缀等于没配:

  • 密码统一走 spring.redis.password(集群所有节点必须相同,且不能含逗号、空格、斜杠等分隔符)
  • 超时统一用 spring.redis.timeout(socket 级,建议 ≥2000ms,避免网络抖动触发误判)
  • 连接池只对 Lettuce 有效:用 spring.data.redis.lettuce.pool.*,比如 spring.data.redis.lettuce.pool.max-idle=100;Jedis 的池配置是 spring.redis.jedis.pool.*,但 Spring Boot 2.3+ 不再自动装配 Jedis,除非你手动排除 Lettuce 并引入 Jedis 依赖
  • spring.redis.cluster.command-timeout 已被废弃(Spring Boot 3.x 起移除),应改用 spring.redis.timeout

最容易被忽略的是:集群模式下 spring.redis.host 和 spring.redis.port 会被完全忽略,哪怕它们存在也不会报错 —— 这会让开发者误以为配置生效了,实则连的是单机 fallback 地址(如果启用了 fallback)。务必删掉这两项,只保留 cluster.nodes 及其配套参数。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.08.06

2431

22

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

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

2026.01.26

457

25

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

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

2023.11.02

4369

19

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

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

2023.11.14

3895

11

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

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

2024.04.02

7092

6

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

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

2024.04.07

623

6

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

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

2024.04.07

756

6

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

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

2024.04.07

6802

6

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

1160

6

热门下载

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

精品课程

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

共0课时 | 0人学习