Forge Admin

Appearance

🔒 升级 PRO

START-REDIS-CONNECTION-FAILED ​

错误编号：START-REDIS-CONNECTION-FAILED

认证失败走 START-REDIS-AUTH-FAILED。

适用版本 / 权益 ​

免费。缓存、Sa-Token 独立 Redis、分布式锁都依赖这套连接。

典型报错关键词 ​

  • Unable to connect to Redis
  • Connection refused
  • Redisson 连不上 6379

用户会看到什么 ​

Admin 启动或运行时访问 Redis 失败，还不是 WRONGPASS / NOAUTH。

发生原因 ​

Redis 没起来，或 spring.data.redis.host / port 不对。

配置位置 ​

官方示例 application-dev.example.yml：

键示例
spring.data.redis.hostlocalhost
spring.data.redis.port6379
spring.data.redis.database0
spring.data.redis.timeout10s
spring.data.redis.ssl.enabledfalse
sa-token.alone-redis.host${spring.data.redis.host}
sa-token.alone-redis.port${spring.data.redis.port}

Redisson 还有 spring.data.redis.redisson.config 里的 singleServerConfig.address。

正确配置 ​

host/port 与 Redis 实际监听一致。密码见认证页，这里不写示例口令。

解决步骤 ​

  1. redis-cli -h <host> -p 6379 ping，期望 PONG（若开了密码会先认证失败，转到认证页）。
  2. Docker 环境确认 Redis 容器在跑。
  3. 核对 YAML 端口是 6379，不是 MySQL 3306，也不是 Admin 8580。
  4. Sa-Token alone-redis 引用同一套 host/port。

验证方法 ​

redis-cli ping 成功后启动 Admin，日志不再报 Redis 连接拒绝。

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

  • 本错误编号
  • host 是否本机、端口号
  • 不要提供 Redis 密码

相关文档 ​