php报错PHP Fatal error: Uncaught exception &#039;RedisException&#039; with message Redis server went away

封面图 • 2025-10-11 • PHP

你遇到的错误信息是：

```
PHP Fatal error: Uncaught exception 'RedisException' with message 'Redis server went away'
```

这个错误表示 PHP 在尝试与 Redis 服务器通信时，连接被中断了。也就是说，**Redis 服务端断开了连接**，导致 PHP 抛出异常。

---

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

### 1. **Redis 服务未运行**
- 检查 Redis 是否正在运行：
  ```bash
  redis-cli ping
  ```
  如果返回 `PONG` 表示 Redis 正在运行；否则需要启动它：
  ```bash
  sudo systemctl start redis
  # 或者
  redis-server /etc/redis/redis.conf
  ```

---

### 2. **连接超时（timeout）**
Redis 默认可能设置了 `timeout` 配置项（单位：秒），如果长时间没有操作，连接会被 Redis 自动关闭。

#### 解决方法：
- 修改 Redis 的 `timeout` 配置（默认是 300 秒）：
  ```conf
  timeout 0  # 设置为 0 表示永不超时
  ```
  然后重启 Redis：
  ```bash
  sudo systemctl restart redis
  ```

- 或者在 PHP 中设置连接超时时间（通过 `setOption`）：
  ```php
  $redis = new Redis();
  $redis->connect('127.0.0.1', 6379);
  $redis->setOption(Redis::OPT_READ_TIMEOUT, -1); // 不设超时
  ```

---

### 3. **网络问题**
- 检查 Redis 服务器是否可以被 PHP 脚本访问。
- 检查防火墙或安全组设置（如果是远程 Redis）：
  ```bash
  telnet <redis_host> 6379
  ```
  如果无法连接，可能是网络不通或端口未开放。

---

### 4. **PHP Redis 扩展配置问题**
- 确保你使用的是正确的 Redis 扩展（如 `php-redis` 或 `predis`）。
- 检查 `php.ini` 中是否加载了 Redis 扩展：
  ```ini
  extension=redis.so
  ```

---

### 5. **PHP 脚本执行时间过长**
- 如果 PHP 脚本执行时间超过 Redis 的 `timeout` 时间，Redis 会断开连接。
- 可以增加脚本执行时间限制（但不推荐长期这么做）：
  ```php
  set_time_limit(0);
  ```

---

## 🛠️ 推荐调试步骤

1. 确认 Redis 服务是否正常运行：
   ```bash
   redis-cli ping
   ```

2. 检查 PHP 连接 Redis 的代码是否正确：
   ```php
   $redis = new Redis();
   $redis->connect('127.0.0.1', 6379);
   if ($redis->ping() === 'PONG') {
       echo "Connected to Redis.";
   } else {
       echo "Failed to connect.";
   }
   ```

3. 查看 Redis 日志（通常在 `/var/log/redis/redis-server.log`）：
   ```bash
   tail -f /var/log/redis/redis-server.log
   ```

---

## ✅ 总结

| 原因 | 解决方案 |
|------|----------|
| Redis 未运行 | 启动 Redis 服务 |
| 超时设置太短 | 修改 `timeout` 为 0 或增加超时时间 |
| 网络问题 | 检查网络和防火墙 |
| PHP 脚本执行太久 | 增加脚本执行时间或优化逻辑 |
| Redis 扩展问题 | 检查扩展是否安装、配置正确 |

---

如果你愿意提供你的 PHP 代码片段或 Redis 配置，我可以更具体地帮你分析问题。

php报错PHP Fatal error: Uncaught exception &amp;#039;RedisException&amp;#039; with message Redis server went away

php报错PHP Fatal error: Uncaught exception 'RedisException' with message Redis server went away