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

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

浅萱吖_9500

浅萱吖_9500

发布时间:2026-06-14 07:24:19

|

652人浏览过

|

来源于php中文网

原创

直接配置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 及其配套参数。

热门AI工具

更多
WorkBuddy

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

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

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

豆包大模型

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

音述AI
音述AI Hot

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

相关专题

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

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

2431

2025.08.06

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

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

457

2026.01.26

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

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

4369

2023.11.02

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

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

3895

2023.11.14

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

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

7092

2024.04.02

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

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

643

2024.04.07

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

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

756

2024.04.07

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

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

6822

2024.04.07

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

热门下载

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

精品课程

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

共0课时 | 0人学习

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

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