解决 Redis 连接被拒绝错误：Could not connect to Redis at 127.0.0.1 6379 Connection Refused

Redis 服务连接错误“Could not connect to Redis at 127.0.0.1:6379: Connection Refused”是用户在连接 Redis 数据库时常见的错误。这通常意味着客户端无法成功与 Redis 服务建立连接。本文将逐步带您检查并解决这个问题。

1. 检查 Redis 服务是否启动

• 命令：运行以下命令来查看 Redis 是否正在运行：

  sudo systemctl status redis
  

• 解释：如果服务显示为“active (running)”，说明 Redis 正在运行。若显示“inactive”或“failed”，说明 Redis 未启动。

2. 启动 Redis 服务

• 命令：如果 Redis 没有运行，可以尝试启动服务：

  sudo systemctl start redis
  

• 注意：启动后可以再次运行 status 命令确认服务是否成功启动。

3. 检查 Redis 端口配置

• 命令：查看 Redis 配置文件，以确保 Redis 正在监听正确的 IP 地址和端口。配置文件通常位于 /etc/redis/redis.conf。
• 步骤：打开配置文件：

  sudo nano /etc/redis/redis.conf
  

  确保 bind 设置为 127.0.0.1，且 port 设置为 6379。示例：

  bind 127.0.0.1
  port 6379
  

• 解释：如果 bind 设置为其他地址，或 port 不是 6379，会导致客户端无法连接。

4. 检查防火墙设置

• 原因：防火墙可能会阻止 Redis 连接请求。
• 命令：检查防火墙规则，确保允许 6379 端口：

  sudo ufw allow 6379
  

• 解释：在某些情况下，防火墙会阻止未授权的端口请求，开放 6379 端口可以解决连接被拒绝的问题。

5. 确认 Redis 版本和日志

• 原因：有时候 Redis 服务版本过旧或与系统不兼容也会导致错误。
• 命令：检查 Redis 日志来获取错误详细信息：

  sudo tail -f /var/log/redis/redis-server.log
  

• 解释：日志文件通常会记录导致服务启动失败的原因，帮助进一步排查。

6. 重启 Redis 并测试连接

• 命令：在确认配置文件无误后，重启 Redis：

  sudo systemctl restart redis
  

• 测试：使用命令行 Redis 客户端测试连接：

  redis-cli ping
  

• 解释：如果返回 PONG，说明连接成功。

按照以上步骤，逐一检查 Redis 服务状态、端口配置和防火墙设置，通常可以找到问题并成功解决 Redis 连接被拒绝的错误。