讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

在Spring Boot 3中如何为RedisCluster配置密码认证?

风萱吖_8728

风萱吖_8728

发布时间:2026-11-20 09:37:36

|

832人浏览过

|

来源于php中文网

原创

Spring Boot 3 中 Redis Cluster 密码必须配置为 spring.redis.cluster.password,spring.redis.password 在集群模式下被 Lettuce 客户端忽略,否则触发 NOAUTH 错误。

在spring boot 3中如何为rediscluster配置密码认证?

Spring Boot 3 中 Redis Cluster 密码必须用 spring.redis.cluster.password,配 spring.redis.password 完全无效——这是最常导致 NOAUTH Authentication required 错误的根本原因。

为什么 spring.redis.password 在集群模式下不生效

Spring Boot 2.0+ 的 Lettuce 集群客户端明确忽略 spring.redis.password,只读取 spring.redis.cluster.password 并将其作为 AUTH 命令参数透传给每个节点。即使你把 spring.redis.password 写对了,启动日志里也看不到报错,但第一次执行 set 或 get 就会抛出 RedisCommandExecutionException: NOAUTH 或静默超时。

常见错误现象包括:

  • 应用能正常启动,RedisConnectionFactory 创建成功
  • 调用 redisTemplate.opsForValue().set("k", "v") 报 NOAUTH Authentication required
  • 日志中出现 MOVED 重定向失败或 ReadTimeoutException,实则是认证被拒后连接中断

application.yml 中的正确写法(Spring Boot 3)

Spring Boot 3 默认使用 Lettuce,且要求 spring-data-redis ≥ 3.0.0(对应 Redis 7+ 兼容性),配置必须严格按层级书写:

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载
spring:
  redis:
    cluster:
      nodes: 127.0.0.1:7001,127.0.0.1:7002,127.0.0.1:7003
      password: myclusterpass
      max-redirects: 3
    timeout: 2000
    lettuce:
      pool:
        max-active: 8
        max-idle: 8
        min-idle: 0

注意要点:

  • password 必须嵌套在 cluster: 下,不能提级到 redis: 层
  • 所有集群节点的 requirepass 值必须完全一致(大小写、空格、特殊字符)
  • 若用 redis:// URL 格式写节点(如 redis://127.0.0.1:7001),URL 中的密码会被忽略,仍以 cluster.password 为准
  • max-redirects 建议显式设为 3(默认是 5),避免因认证失败节点引发无限重定向

Java 配置类中手动构造 RedisClusterConfiguration 的风险点

有人为了“可控”选择手写 @Configuration 类并 new RedisClusterConfiguration,这反而容易绕过 Spring Boot 自动装配的密码注入逻辑:

  • 如果调用 redisClusterConfiguration.setPassword(password) 但传入的是 @Value("${spring.redis.password}"),那就又掉进单机配置陷阱
  • Lettuce 要求密码必须通过 RedisClusterConfiguration 的 setPassword() 设置,且该对象最终要交给 LettuceClientConfigurationBuilderCustomizer 或直接用于构建 LettuceConnectionFactory
  • Spring Boot 3 推荐零配置优先,除非有定制拓扑发现或 SSL 等高级需求,否则不要手动 new 配置类

验证是否真正生效的简单方法

别只看启动日志有没有异常,要真连上去测认证状态:

  • 用 redis-cli -c -h 127.0.0.1 -p 7001 -a myclusterpass 手动连任意节点,执行 cluster nodes 看是否返回完整拓扑
  • 在代码里加一行测试:redisTemplate.execute((RedisCallback<string>) con -> con.ping())</string>,成功返回 PONG 才算通
  • 检查 RedisConnectionFactory 实例的类型:如果是 LettuceConnectionFactory,且其 clusterConfiguration 字段的 password 属性非 null,说明配置已加载

最容易被忽略的是 Redis 服务端配置本身:集群各节点的 redis.conf 里必须同时存在 requirepass 和 masterauth(主从同步用),且值完全一致;漏掉 masterauth 会导致从节点无法认证主节点,整个集群状态异常,此时客户端哪怕密码配对了也会行为不稳定。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

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

音述AI
音述AI Hot

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

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

DeepSeek

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

相关专题

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

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

3071

2025.08.06

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

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

537

2026.01.26

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

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

5069

2023.11.02

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

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

4655

2023.11.14

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

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

9112

2024.04.02

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

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

683

2024.04.07

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

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

796

2024.04.07

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

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

9602

2024.04.07

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go-Zero官方文档
Go-Zero官方文档

共0课时 | 0人学习

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

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