# Connect异常：工作器配置必须恰好设置'key.converter'或'value.converter'之一，但发现0个

- **ID:** `kafka/connect-worker-config-mismatch`
- **领域:** kafka
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 95%

## 根因

Kafka Connect工作器缺少键或值序列化所需的转换器配置，导致启动失败。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Kafka 3.6.0 | active | — | — |
| Kafka 3.7.0 | active | — | — |
| Kafka Connect 3.6.0 | active | — | — |

## 解决方案

1. ```
   Add `key.converter=org.apache.kafka.connect.json.JsonConverter` and `value.converter=org.apache.kafka.connect.json.JsonConverter` in worker.properties, then restart the worker.
   ```
2. ```
   Example fix in worker.properties: `key.converter=org.apache.kafka.connect.storage.StringConverter` and `value.converter=org.apache.kafka.connect.json.JsonConverter` for mixed formats.
   ```
3. ```
   Check environment variable overrides: `echo $CONNECT_KEY_CONVERTER` and ensure they are not conflicting.
   ```

## 无效尝试

- **** — The error says exactly one must be set; setting both does not fix the missing configuration. (70% 失败率)
- **** — Defaults are not guaranteed and may not match the connector's data format. (80% 失败率)