# org.apache.kafka.common.errors.UnsupportedVersionException: 代理不支持消费者所需的组协议版本

- **ID:** `kafka/unsupported-version-join-group`
- **领域:** kafka
- **类别:** protocol_error
- **验证级别:** ai_generated
- **修复率:** 88%

## 根因

消费者请求的组协议版本（例如2）代理不支持，原因是消费者和代理之间的版本不匹配。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.0.0 | active | — | — |
| 3.3.0 | active | — | — |
| 3.6.0 | active | — | — |

## 解决方案

1. ```
   将消费者的 'group.protocol' 设置为 'classic'，并确保代理支持经典协议（Kafka 3.0+）。
   ```
2. ```
   升级代理到支持消费者组协议的版本（例如，升级到3.6以支持消费者协议v2）。
   ```
3. ```
   降级消费者客户端库以匹配代理版本（例如，使用kafka-clients 3.3.0与代理3.3.0）。
   ```

## 无效尝试

- **** — Classic protocol may not be supported by older brokers; error persists if broker version is too low. (75% 失败率)
- **** — Consumer version mismatch with broker causes unsupported version errors; both must be compatible. (90% 失败率)
- **** — Inter-broker protocol version affects broker communication, not consumer group protocol; does not fix consumer-side error. (80% 失败率)