Redis 连接鉴权问题排查与解决指南

一、问题现象

连接 Redis 时出现：

(error) NOAUTH Authentication required

springBoot项目本地部署连接报错

Caused by: org.redisson.client.RedisAuthRequiredException: NOAUTH Authentication required.. channel: [id: 0xc57cacec, L:/127.0.0.1:61006 - R:/127.0.0.1:6379] data: CommandData [promise=RedissonPromise [promise=ImmediateEventExecutor$ImmediatePromise@5493992f(incomplete)], command=(PING), params=[], codec=null]
	at org.redisson.client.handler.CommandDecoder.decode(CommandDecoder.java:354)
	at org.redisson.client.handler.CommandDecoder.decodeCommand(CommandDecoder.java:196)
	at org.redisson.client.handler.CommandDecoder.decode(CommandDecoder.java:134)
	at org.redisson.client.handler.CommandDecoder.decode(CommandDecoder.java:104)
	at io.netty.handler.codec.ByteToMessageDecoder.decodeRemovalReentryProtection(ByteToMessageDecoder.java:508)
	at io.netty.handler.codec.ReplayingDecoder.callDecode(ReplayingDecoder.java:366)
	at io.netty.handler.codec.ByteToMessageDecoder.channelRead(ByteToMessageDecoder.java:276)
	at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:379)
	at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:365)
	at io.netty.channel.AbstractChannelHandlerContext.fireChannelRead(AbstractChannelHandlerContext.java:357)
	at io.netty.channel.DefaultChannelPipeline$HeadContext.channelRead(DefaultChannelPipeline.java:1410)
	at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:379)
	at io.netty.channel.AbstractChannelHandlerContext.invokeChannelRead(AbstractChannelHandlerContext.java:365)
	at io.netty.channel.DefaultChannelPipeline.fireChannelRead(DefaultChannelPipeline.java:919)
	at io.netty.channel.nio.AbstractNioByteChannel$NioByteUnsafe.read(AbstractNioByteChannel.java:166)
	at io.netty.channel.nio.NioEventLoop.processSelectedKey(NioEventLoop.java:719)
	at io.netty.channel.nio.NioEventLoop.processSelectedKeysOptimized(NioEventLoop.java:655)
	at io.netty.channel.nio.NioEventLoop.processSelectedKeys(NioEventLoop.java:581)
	at io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:493)
	... 4 

表示 Redis 要求密码认证，但我们没有设置密码，且已经检查了redis配置文件并重启了redis;

二、排查思路

Redis 运行需要两个关键部分：

1. 程序文件（redis-server）
2. 配置文件（redis.conf）

如果这两个部分指向了错误的位置，就会导致问题。

三、排查步骤

1. 检查 Redis 程序文件的位置

# 查看 brew 安装的 redis 的具体文件
brew list redis

# 查看当前使用的 redis-server 命令指向哪里
which redis-server
# 输出：/usr/local/bin/redis-server

# 查看这个命令实际指向的具体位置
ls -l /usr/local/bin/redis-server
# 输出：/usr/local/bin/redis-server -> /usr/local/opt/redis/bin/redis-server

发现问题：

• 当前 redis-server 命令指向了 /usr/local/opt/redis/bin/redis-server
• 但实际安装位置是 /usr/local/Cellar/redis/8.0.0/bin/redis-server
• 这说明快捷方式指向了错误的位置

2. 检查配置文件的位置

# 查看当前使用的配置文件位置
ls -l /usr/local/etc/redis.conf
# 输出：/usr/local/etc/redis.conf -> /usr/local/opt/redis/etc/redis.conf

# 查看实际安装的配置文件位置
ls -l /usr/local/Cellar/redis/8.0.0/.bottle/etc/redis.conf

发现问题：

• 当前使用的配置文件指向了 /usr/local/opt/redis/etc/redis.conf
• 但实际安装的配置文件在 /usr/local/Cellar/redis/8.0.0/.bottle/etc/redis.conf
• 这说明配置文件也指向了错误的位置

四、解决方案

1. 停止 Redis 服务

brew services stop redis

2.清理错误的快捷方式

# 删除错误的 redis-server 快捷方式
sudo rm /usr/local/bin/redis-server
# 删除错误的配置文件快捷方式
sudo rm -rf /usr/local/opt/redis

解释一下这里删除/usr/local/opt/redis的逻辑：

# 查看这个命令实际指向的具体位置
ls -l /usr/local/bin/redis-server
# 输出：/usr/local/bin/redis-server -> /usr/local/opt/redis/bin/redis-server

redis-server 的快捷方式指向了 /usr/local/opt/redis/bin/redis-server而不是直接指向实际安装位置说明存在中间快捷方式

# 检查 /usr/local/opt/redis 是什么
ls -l /usr/local/opt/redis
# 输出：/usr/local/opt/redis -> /usr/local/Cellar/redis/8.0.0

• /usr/local/opt/redis 本身也是一个快捷方式
• 它指向了实际的安装目录 /usr/local/Cellar/redis/8.0.0
• 这形成了一个"快捷方式的快捷方式"

3.重新创建正确的快捷方式

 # 创建正确的 redis-server 快捷方式
brew link --overwrite redis

4.复制正确的配置文件

# 将实际安装的配置文件复制到正确的位置
sudo cp /usr/local/Cellar/redis/8.0.0/.bottle/etc/redis.conf /usr/local/etc/redis.conf

5.修改配置文件

编辑 /usr/local/etc/redis.conf，设置：

protected-mode no
requirepass ""

6.重启 Redis 服务

brew services start redis

五、验证解决

1.检查快捷方式是否正确

# 检查 redis-server 命令指向
which redis-server
ls -l /usr/local/bin/redis-server
# 应该指向：/usr/local/Cellar/redis/8.0.0/bin/redis-server

2.检查配置文件是否正确

# 检查配置文件位置
ls -l /usr/local/etc/redis.conf
# 应该指向正确的配置文件

3.测试连接

redis-cli ping
# 应该返回：PONG

六、总结

问题的根本原因是：

1. Redis 程序文件的快捷方式指向了错误的位置
2. 配置文件的快捷方式也指向了错误的位置

解决方法就是：

1. 删除错误的快捷方式
2. 重新创建指向正确位置的快捷方式
3. 使用正确的配置文件