Redis报错: failed with errno=10054

封面图 • 2025-12-24 • redis

Redis 报错 `failed with errno=10054` 是一个常见的网络错误，通常发生在客户端与 Redis 服务器之间的连接被**意外断开**时。这个错误对应的 Windows 系统错误码是 `10054`，表示：

> **WSAECONNRESET**  
> 连接被对方重置（远程主机强制关闭了一个现有的连接）。

---

### 🧩 常见原因分析

#### 1. **Redis 服务端主动断开了连接**
- Redis 服务器可能因为超时、配置限制（如 `timeout` 或 `maxclients`）、内存不足等原因主动断开了连接。
- 例如：如果 Redis 的 `timeout` 设置为 300 秒（默认），而客户端长时间没有通信，Redis 会断开连接。

#### 2. **网络不稳定或中断**
- 客户端和 Redis 服务器之间的网络连接不稳定或中断，导致连接被重置。
- 可能是防火墙、路由器、负载均衡器等中间设备断开了连接。

#### 3. **客户端未正确处理连接**
- 客户端代码中未正确处理异常或未实现重连机制，导致在连接断开后直接报错。
- 例如：使用 `redis-py`（Python 的 Redis 客户端）时，如果连接断开后没有重新建立连接，就会抛出此错误。

#### 4. **Redis 配置问题**
- 检查 Redis 配置文件中的 `timeout`、`tcp-keepalive` 等参数是否合理。
- 如果设置了 `timeout`，但客户端没有定期发送命令，Redis 会主动断开连接。

---

### 🔍 如何排查？

#### ✅ 检查 Redis 日志
查看 Redis 的日志文件（通常是 `redis-server.log`），确认是否有以下信息：
- `Connection closed`
- `Client timeout`
- `Max clients reached`

#### ✅ 检查客户端日志
查看你的应用日志，确认错误发生时的上下文：
- 是否有长时间无操作？
- 是否有大量并发请求？
- 是否有异常重试逻辑？

#### ✅ 检查网络连接
- 使用 `telnet` 或 `ping` 测试 Redis 服务器的连通性。
- 使用 `netstat` 或 `Wireshark` 抓包分析连接状态。

#### ✅ 检查 Redis 配置
检查 Redis 配置文件中的关键参数：
```ini
timeout 300             # 默认 300 秒，超过该时间无通信则断开连接
tcp-keepalive 300       # TCP 心跳间隔（单位秒）
maxmemory <value>       # 内存限制
```

---

### 🛠 解决方案

#### 1. **增加 Redis 超时时间**
如果你的应用需要长时间保持连接，可以适当增大 `timeout`：
```bash
redis-cli config set timeout 600
```

或者在配置文件中修改：
```ini
timeout 600
```

#### 2. **启用 TCP Keepalive**
确保 Redis 服务器启用了 TCP Keepalive，防止空闲连接被中间设备断开：
```ini
tcp-keepalive 300
```

#### 3. **客户端添加重连机制**
在客户端代码中添加重连逻辑，例如：
```python
import redis
import time

def get_redis_connection():
    while True:
        try:
            return redis.Redis(host='localhost', port=6379, db=0)
        except Exception as e:
            print(f"Connection failed: {e}, retrying...")
            time.sleep(1)
```

#### 4. **优化客户端行为**
- 定期发送 `PING` 命令保持连接活跃。
- 在连接断开后及时重连。

---

### ✅ 总结

| 错误码 | 含义 | 常见原因 | 解决方法 |
|--------|------|----------|----------|
| `10054` | WSAECONNRESET | 连接被远程主机重置 | 检查网络、Redis 配置、客户端重连机制 |

---

如果你能提供更具体的上下文（比如使用的语言、Redis 版本、客户端库等），我可以给出更针对性的建议。欢迎继续提问！