-
开发环境
springboot 2.4.3
spring-boot-starter-data-redis 2.4.3
redis 4.0
lettuce 6.0.2 -
背景
多环境(test,pre,prd)部署,在测试环境测试通过之后部署预发环境的时候,服务一直报错,提示【io.lettuce.core.RedisCommandExecutionException: NOAUTH Authentication required.】,这个提示一般情况下的意思是:redis服务配置了密码,客户端链接的时候没有填写密码。但是代码和测试环境同一套的,在测试环境都正常测试通过了的。
连接使用Redis后报错
java.util.concurrent.CompletionException: io.lettuce.core.RedisCommandExecutionException: NOAUTH Authentication required. at java.util.concurrent.CompletableFuture.encodeThrowable(CompletableFuture.java:292) at java.util.concurrent.CompletableFuture.completeThrowable(CompletableFuture.java:308) at java.util.concurrent.CompletableFuture.uniCompose(CompletableFuture.java:943) at java.util.concurrent.CompletableFuture$UniCompose.tryFire(CompletableFuture.java:926) at java.util.concurrent.CompletableFuture.postComplete(CompletableFuture.java:474) at java.util.concurrent.CompletableFuture.completeExceptionally(CompletableFuture.java:1977) at io.lettuce.core.RedisHandshake.lambda$tryHandshakeResp3$1(RedisHandshake.java:105) at java.util.concurrent.CompletableFuture.uniWhenComplete(CompletableFuture.java:760) at java.util.concurrent.CompletableFuture$UniWhenComplete.tryFire(CompletableFuture.java:736) at java.util.concurrent.CompletableFuture.postComplete(CompletableFuture.java:474) at java.util.concurrent.CompletableFuture.completeExceptionally(CompletableFuture.java:1977) at io.lettuce.core.protocol.AsyncCommand.doCompleteExceptionally(AsyncCommand.java:139) at io.lettuce.core.protocol.AsyncCommand.completeResult(AsyncCommand.java:120) at io.lettuce.core.protocol.AsyncCommand.complete(AsyncCommand.java:111) at io.lettuce.core.protocol.CommandHandler.complete(CommandHandler.java:720) at io.lettuce.core.protocol.CommandHandler.decode(CommandHandler.java:655) at io.lettuce.core.protocol.CommandHandler.channelRead(CommandHandler.java:572) 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)
原因分析:
springboot简单整合redis,用的是lettuce客户端,提示没有授权,密码是对的,命令行验证过。所以,不应该是代码问题。也debug验证过,代码可以获取到密码配置项。
所以,应该是客户端问题版本问题,去官网搜一下issue,发现有人已经反馈过了。
通过抓包发现lettuce 6.x默认使用RESP3协议请求云服务器redis服务4.x,导致不支持。后续验证了官方的redis4.0.11是支持的。因为云服务器返回的不是RESP3协议不支持而是验证失败。Lettuce 6 尝试自动发现协议
Lettuce 6.x版本开始,使用RESP3(Redis 6.x引入)的HELLO命令进行版本自适应判断,但是对于不支持HELLO命令(使用hello命令判断是否能够连接redis)的低版本实例,兼容性存在一定问题。
所以对于低版本的实例,建议直接在Lettuce中指定使用RESP2协议(兼容Redis 4/5)的版本来使用。
这个地方还需要特殊提到另一个情况,因为我们经常使用到的是云服务,各大云厂商对redis进行了魔改,因此即使是高版本的redis也存在leetuce 6.x无法连接使用。
根据上述,就必须降级lettuce或者指定redis版本或其它方式手动解决解决这个问题 -
解决方案
3.1 看了lettuce官网的release貌似还没解决这个问题,所以降级一下lettuce版本到5.3.7,问题解决了。
<!-- redis --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId><exclusions><exclusion><groupId>io.lettuce</groupId><artifactId>lettuce-core</artifactId></exclusion></exclusions></dependency><dependency><groupId>io.lettuce</groupId><artifactId>lettuce-core</artifactId><version>5.3.7.RELEASE</version><scope>compile</scope></dependency><!-- 要用redis连接池 必须有pool依赖--><dependency><groupId>org.apache.commons</groupId><artifactId>commons-pool2</artifactId><version>2.5.0</version></dependency>
3.2 通过指定redis的协议来进行处理
RedisClient redisClient = RedisClient.create(RedisURI.Builder.redis("x.x.x.x",6379).withPassword("laosiji123".toCharArray()).withDatabase(6).build()); redisClient.setOptions(ClientOptions.builder().protocolVersion(ProtocolVersion.RESP2).build());
3.3 这是 Spring Boot 的最佳实践,也是通过指定协议来处理
@Configuration public class SpringConfig implements LettuceClientConfigurationBuilderCustomizer {@Override public void customize(LettuceClientConfiguration.LettuceClientConfigurationBuilder clientConfigurationBuilder) { // manually specifying RESP2 clientConfigurationBuilder.clientOptions(ClientOptions.builder() .protocolVersion(ProtocolVersion.RESP2) .build()); }}