org.springframework.data.redis.RedisConnectionFailureException: Unable to connect to Redis 是一个在使用 Spring Data Redis 访问 Redis 时常见的错误，它通常意味着应用程序无法与 Redis 服务器建立连接。解决这个问题需要对几个可能的原因进行排查。以下是一些常见原因及其解决方法，希望能对你有所帮助。
1. 检查 Redis 服务状态
首先，确保 Redis 服务正在运行。可以通过以下命令检查 Redis 服务的状态：
# Linux / macOS
ps aux | grep redis
# 或者使用 Redis 提供的客户端
redis-cli ping
如果返回 PONG，表示 Redis 服务正常。如果服务未运行，可以通过以下命令启动 Redis：
# 启动 Redis 服务
redis-server /path/to/your/redis.conf
2. 检查 Redis 配置文件
确保你的 Redis 配置文件（通常是 redis.conf）设置正确，特别是 bind 和 port 配置项。默认情况下，Redis 绑定到 127.0.0.1（本地地址）和端口 6379。如果你的应用程序在不同的机器上运行，需要确保 bind 指向 0.0.0.0 或具体的 IP 地址。
示例配置：
bind 0.0.0.0
port 6379
重新启动 Redis 服务以应用更改。
3. 检查网络连接
如果你的应用程序与 Redis 服务器不在同一台机器上，检查两个机器之间的网络连接。可以使用 telnet 命令测试连接：
telnet <redis-server-ip> 6379
如果无法连接，可能需要检查防火墙设置或网络策略。
4. 检查 Spring Boot 配置
确保在 Spring Boot 的 application.properties 或 application.yml 中配置 Redis 的连接信息正确。例如：
spring:
data:
redis:
host: localhost
port: 6379
password: yourpassword # 如果你设置了密码
如果你使用的是 application.properties 文件，相应的配置如下：
spring.data.redis.host=localhost
spring.data.redis.port=6379
spring.data.redis.password=yourpassword
5. 使用正确的 Redis 客户端
在使用 Spring Data Redis 时，确保你在 pom.xml 中添加了适当的依赖。以下是一个基本的依赖配置示例：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
你也可以根据需要选择合适的 Redis 客户端，如 Jedis 或 Lettuce。确保使用的客户端版本与你的 Spring Boot 版本相兼容。
6. 示例代码
以下是一个简单的 Spring Boot 应用程序示例，演示如何连接到 Redis 并存取数据：
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class RedisController {
@Autowired
private RedisTemplate<String, String> redisTemplate;
@GetMapping("/set")
public String setKeyValue() {
redisTemplate.opsForValue().set("key", "value");
return "Key-Value set in Redis";
}
@GetMapping("/get")
public String getValue() {
return redisTemplate.opsForValue().get("key");
}
}
总结
当遇到 RedisConnectionFailureException 异常时，首先要从 Redis 服务状态、配置文件、网络连接、Spring Boot 配置以及依赖库等多个方面进行排查。通过系统化的检查和调试，大部分问题都能得到解决。希望本篇文章能够帮助你更有效地解决 Redis 连接问题，顺利地搭建和使用 Redis 数据库。
