# 错误：客户端缓冲区限制超限：客户端 0x7f1234567890 的输出缓冲区

- **ID:** `redis/max-client-buffer-limit-exceeded`
- **领域:** redis
- **类别:** resource_error
- **错误码:** `ERR`
- **验证级别:** ai_generated
- **修复率:** 88%

## 根因

Redis 客户端输出缓冲区超过配置限制，导致连接被终止。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| redis 6.0 | active | — | — |
| redis 7.0 | active | — | — |
| redis 7.2 | active | — | — |

## 解决方案

1. ```
   使用 CLIENT LIST 命令识别问题客户端，然后在 redis.conf 中增加该客户端类型的输出缓冲区限制：
client-output-buffer-limit pubsub 64mb 32mb 60
   ```
2. ```
   优化消费者代码以更快处理消息，或使用消息队列将 Redis 与慢消费者解耦。
   ```

## 无效尝试

- **** — Increasing output buffer limit globally may mask underlying issue of slow consumers. (65% 失败率)
- **** — Restarting Redis server without addressing buffer configuration only provides temporary relief. (80% 失败率)