Redis 配置与排错说明

Redis 配置与排错说明

适用项目:dkd-parent(若依 RuoYi 架构)

适用环境:本地开发,Windows 版 Redis(C:\Program Files\Redis\)

1. 应用端配置位置

Redis 连接配置在 dkd-admin/src/main/resources/application.yml:

yaml 复制代码
spring:
  redis:
    # 地址
    host: localhost
    # 端口,默认为 6379
    port: 6379
    # 数据库索引
    database: 0
    # 密码(本地 Redis 未设置密码时留空)
    password:
    # 连接超时时间
    timeout: 10s
    lettuce:
      pool:
        min-idle: 0
        max-idle: 8
        max-active: 8
        max-wait: -1ms

2. 核心原则:两边密码必须一致

Redis 的密码是服务端全局属性,客户端(应用)与服务端必须保持一致:

Redis 服务端 application.yml 的 password 结果
无密码 留空 ✅ 正常
无密码 填了值(如 root) ❌ ERR Client sent AUTH, but no password is set
有密码 留空 ❌ NOAUTH Authentication required
有密码 与服务端相同 ✅ 正常

因为多个项目常连同一个 Redis,一旦服务端设了密码,每个项目都要在各自配置里填上相同密码。

3. 本地开发建议

本地开发且 Redis 不对外网开放时,可以不设置密码 ,password 留空即可,最省事,其他项目也无需改动。

生产环境 / 服务器 / 端口对外暴露时,必须设置密码,并建议同时修改默认端口、绑定内网 IP、配置防火墙。

4. 给 Redis 设置密码(可选)

方式一:临时设置(重启 Redis 后失效)

powershell 复制代码
cd "C:\Program Files\Redis"
.\redis-cli.exe

在交互界面执行:

复制代码
CONFIG SET requirepass "root"

之后连接需带密码:.\redis-cli.exe -a root

方式二:永久设置(改配置文件)

  1. 打开配置文件:

    • 以服务方式启动:C:\Program Files\Redis\redis.windows-service.conf
    • 手动启动:C:\Program Files\Redis\redis.windows.conf
  2. 找到被注释的 # requirepass foobared,改为:

    复制代码
    requirepass root
  3. 重启 Redis 服务:

    powershell 复制代码
    Get-Service *redis*
    Restart-Service Redis
  4. 同步修改应用配置 :把 application.yml 的 password 改为 root,保持两边一致。

5. 常见报错速查

5.1 ERR Client sent AUTH, but no password is set

  • 含义:应用填了密码,但 Redis 服务端没设密码。
  • 处理:把 application.yml 的 password 留空,或给 Redis 设置相同密码。

5.2 NOAUTH Authentication required / invalid password

  • 含义:Redis 有密码,但应用没填或填错。
  • 处理:在 application.yml 填写正确密码。

5.3 Unable to connect to Redis ... localhost:6379

  • 含义:连不上 Redis(服务未启动 / 端口不对 / 未安装)。
  • 处理:确认 Redis 服务已启动(Get-Service *redis* 或任务管理器查看 redis-server.exe),端口为 6379。

5.4 启动时报 captchaController / sysConfigServiceImpl 初始化失败

  • 通常是上面 Redis 连接问题的连锁反应,先解决 Redis 连接即可。
相关推荐
Flynt3 小时前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
数据库急诊室_阿哲3 小时前
一次割接后的性能复核记录:基线、样本、回滚点
运维·数据库·dba
Resean02234 小时前
Spring 源码分析(一)IOC 容器总览与 refresh() 全景
java·后端·spring
保利威视频SaaS小张4 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
顧棟6 小时前
【ES实战】 索引模板「可追溯、可校验」:一种模板治理的工程化思路
java·数据库·elasticsearch
Decay__7 小时前
SQLServer 监控体系构建 —— sql_exporter + Prometheus + Grafana 全栈实战
运维·数据库·sql·mysql·架构
玄昌盛不会编程7 小时前
LeetCode——2243. 计算字符串的数字和
java·算法·leetcode
文丑颜不良啊7 小时前
LeetCode3061~3080题目解析
java·leetcode
tianyuanwo7 小时前
NocoDB 系统手册:PostgreSQL 主机资产管理的界面层实施方案
数据库·postgresql·oracle
装不满的克莱因瓶7 小时前
【AI时代必学】一篇文章教会你从零搭建Serverless架构
java·人工智能·ai·云原生·架构·serverless