Skip to content

START-REDIS-AUTH-FAILED

错误编号:START-REDIS-AUTH-FAILED

适用版本 / 权益

免费。secret=true:响应和文档只写“密码必填、格式要求”,不写当前值。

典型报错关键词

  • NOAUTH Authentication required
  • WRONGPASS
  • invalid password

用户会看到什么

TCP 能连上 Redis,AUTH 失败。

发生原因

spring.data.redis.password、Redisson singleServerConfig.passwordsa-token.alone-redis.password 与 Redis 实际密码不一致,或一处配了、另一处空着。

配置位置

说明
spring.data.redis.password示例文件写 'your_redis_password'
spring.data.redis.redisson.configpassword必须与上面同一套密钥,不要在文档里复制仓库里出现过的字面量
sa-token.alone-redis.password${spring.data.redis.password}

正确配置

三处密码一致,只存在本地未提交文件或密钥管理。生产不要用示例口令。

解决步骤

  1. 确认 Redis 是否要求密码:redis-cli ping 的返回。
  2. 对齐 Spring Data Redis 与 Redisson 两处配置。
  3. YAML 特殊字符要加引号。
  4. 不要把密码贴到日志、截图或 Issue。

验证方法

redis-cli -a <本机密码>PING,再启动 Admin。

仍未解决时提供的安全信息

  • 本错误编号
  • 是否三处密码都配了(是/否)
  • 不要提供密码本身

相关文档