redis-cli 报错 redis Could not connect to Redis at 127.0.0.1:6379

封面图 • 2026-01-03 • redis

你遇到的错误信息：

```
Could not connect to Redis at 127.0.0.1:6379
```

表示 `redis-cli` 无法连接到本地的 Redis 服务器。以下是常见的几种原因和解决方法：

---

## 🔍 常见原因及解决方法

### 1. **Redis 服务没有启动**
这是最常见的原因。

#### 解决方法：
- 在 Linux 或 macOS 上，使用以下命令检查 Redis 是否运行：
  ```bash
  ps aux | grep redis
  ```
  或者：
  ```bash
  systemctl status redis
  ```

- 如果 Redis 没有运行，可以尝试启动它：
  ```bash
  redis-server /etc/redis/redis.conf
  ```
  （具体路径可能根据你的安装方式不同而不同）

- 如果是通过 `brew` 安装的 Redis（macOS）：
  ```bash
  brew services start redis
  ```

---

### 2. **端口被占用或配置错误**
Redis 默认使用的是 `6379` 端口，但如果你修改了配置文件，或者该端口被其他程序占用了，也会导致连接失败。

#### 检查端口是否被占用：
```bash
lsof -i :6379
```

#### 检查 Redis 配置文件中的端口设置：
查看 `/etc/redis/redis.conf` 或其他配置文件中是否有：
```conf
port 6379
```

---

### 3. **防火墙或安全组限制**
在某些情况下，即使 Redis 正常运行，也可能因为防火墙或安全组规则导致连接失败。

#### 检查防火墙设置：
- 在 Linux 上：
  ```bash
  sudo ufw status
  ```
- 如果启用了防火墙，确保允许 `6379` 端口：
  ```bash
  sudo ufw allow 6379
  ```

---

### 4. **绑定地址问题**
默认情况下，Redis 只监听 `127.0.0.1`，但如果配置中设置了 `bind 0.0.0.0`，那么它会监听所有 IP 地址。

#### 检查 Redis 配置文件中的 `bind` 设置：
```conf
bind 127.0.0.1
```

如果你是从远程连接，需要确保 Redis 允许从外部访问（不建议生产环境这么做）。

---

### 5. **权限问题**
有时候 Redis 的配置文件或数据目录权限不对，可能导致服务无法启动。

#### 检查 Redis 日志：
通常日志在 `/var/log/redis/redis-server.log` 或类似位置，可以查看是否有错误信息。

---

### 6. **使用 `redis-cli` 时指定主机和端口**
你可以手动指定连接的主机和端口来测试：
```bash
redis-cli -h 127.0.0.1 -p 6379
```

如果还是报错，说明 Redis 服务本身有问题。

---

## ✅ 小结：排查步骤

1. 检查 Redis 是否正在运行。
2. 检查 Redis 配置文件中的端口、绑定地址等。
3. 检查端口是否被占用或防火墙阻止。
4. 查看 Redis 日志以获取更详细的错误信息。

---

如果你能提供更多信息，比如：
- 你是用什么系统？
- Redis 是怎么安装的？（如：apt、brew、源码编译等）
- Redis 的配置文件内容？

我可以给出更具体的帮助！