# org.apache.kafka.common.errors.TimeoutException：偏移量提交请求在 60000 毫秒后超时

- **ID:** `kafka/offset-commit-future-timeout`
- **领域:** kafka
- **类别:** network_error
- **验证级别:** ai_generated
- **修复率:** 82%

## 根因

消费者向组协调器提交偏移量的请求因网络延迟、协调器不可用或过载而超时。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.2.0 | active | — | — |
| 3.4.0 | active | — | — |
| 3.6.1 | active | — | — |

## 解决方案

1. ```
   Increase the consumer's default.api.timeout.ms to allow more time for offset commits:
props.put(ConsumerConfig.DEFAULT_API_TIMEOUT_MS_CONFIG, 120000);
Also ensure network connectivity to the group coordinator is stable.
   ```
2. ```
   Identify the group coordinator and check its health:
kafka-consumer-groups.sh --bootstrap-server localhost:9092 --group my-group --describe
If the coordinator is overloaded, scale out the broker cluster or reduce the number of consumer groups.
   ```

## 无效尝试

- **** — Enabling auto.offset.commit=false prevents automatic commits but does not fix the underlying network issue. (75% 失败率)
- **** — Increasing session.timeout.ms only affects liveness detection, not commit request timeouts. (85% 失败率)