# 不支持的版本异常：代理不支持该API版本

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

## 根因

客户端和代理的API版本不兼容，通常是由于Kafka客户端库和代理版本不匹配。

## 解决方案

1. ```
   升级Kafka客户端库以匹配代理版本，例如在Maven中：<kafka.version>3.7.0</kafka.version>
   ```
2. ```
   在生产/消费者配置中将 api.version.request 设置为 false，以强制客户端使用特定版本，例如 props.put("api.version.request", "false");
   ```

## 无效尝试

- **** — Downgrading the broker version often introduces security vulnerabilities and is not recommended. (70% 失败率)
- **** — Manually setting API versions in client config can lead to further incompatibilities if not done carefully. (80% 失败率)