START-REDIS-AUTH-FAILED
错误编号:START-REDIS-AUTH-FAILED
适用版本 / 权益
免费。secret=true:响应和文档只写“密码必填、格式要求”,不写当前值。
典型报错关键词
NOAUTH Authentication requiredWRONGPASSinvalid password
用户会看到什么
TCP 能连上 Redis,AUTH 失败。
发生原因
spring.data.redis.password、Redisson singleServerConfig.password、sa-token.alone-redis.password 与 Redis 实际密码不一致,或一处配了、另一处空着。
配置位置
| 键 | 说明 |
|---|---|
spring.data.redis.password | 示例文件写 'your_redis_password' |
spring.data.redis.redisson.config 内 password | 必须与上面同一套密钥,不要在文档里复制仓库里出现过的字面量 |
sa-token.alone-redis.password | ${spring.data.redis.password} |
正确配置
三处密码一致,只存在本地未提交文件或密钥管理。生产不要用示例口令。
解决步骤
- 确认 Redis 是否要求密码:
redis-cli ping的返回。 - 对齐 Spring Data Redis 与 Redisson 两处配置。
- YAML 特殊字符要加引号。
- 不要把密码贴到日志、截图或 Issue。
验证方法
redis-cli -a <本机密码> 能 PING,再启动 Admin。
仍未解决时提供的安全信息
- 本错误编号
- 是否三处密码都配了(是/否)
- 不要提供密码本身
