SpringBoot3+Java17环境下Redis连接失败问题求助

报错信息 #

org.springframework.data.redis.RedisConnectionFailureException: 无法连接到Redis
由 io.lettuce.core.RedisConnectionException: 无法连接到 hostname/[未解析地址]:16379 引起
由 java.net.SocketException: Connection reset（连接重置）引起

排查与解决步骤 #

• 验证Redis服务可用性
  在Redis服务器执行redis-cli ping，返回PONG说明服务正常运行。若为远程Redis，检查防火墙是否开放16379端口：Linux环境用firewall-cmd --query-port=16379/tcp确认，未开放则执行firewall-cmd --add-port=16379/tcp --permanent后重启防火墙。

• 核对连接配置准确性
  检查SpringBoot配置文件（application.yml/application.properties）中的Redis参数：

  spring:
    data:
      redis:
        host: 正确的Redis主机IP/域名
        port: 16379
        password: Redis访问密码（若已设置）
        timeout: 3000
  

  确保host是可正常解析的地址，端口与Redis监听端口完全一致。

• 检查Lettuce客户端兼容性
  SpringBoot3默认使用Lettuce作为Redis客户端，Java17环境下无需手动指定版本（父依赖已管理兼容版本），但如果存在依赖冲突，可在pom.xml中明确引入：

  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
  </dependency>
  

  连接重置可能是TCP层面问题，比如Redismaxclients限制导致连接被拒，可尝试重启Redis服务与应用观察是否恢复。

• 调整Redis绑定地址配置
  打开Redis配置文件redis.conf，检查bind参数：若设置为127.0.0.1则仅允许本地访问，需修改为0.0.0.0（允许所有IP访问）或指定应用服务器IP，修改后重启Redis服务。

内容的提问来源于stack exchange，提问作者Ramesh