{
  "id": "kafka/unsupported-version-broker-api",
  "signature": "org.apache.kafka.common.errors.UnsupportedVersionException: The broker does not support the required API version",
  "signature_zh": "org.apache.kafka.common.errors.UnsupportedVersionException：代理不支持所需的API版本",
  "regex": "UnsupportedVersionException.*does not support the required API version",
  "domain": "kafka",
  "category": "protocol_error",
  "subcategory": null,
  "root_cause": "Kafka client requests an API version that the broker does not support, often due to mismatched client-broker versions.",
  "root_cause_type": "generic",
  "root_cause_zh": "Kafka客户端请求了代理不支持的API版本，通常是由于客户端与代理版本不匹配。",
  "versions": [],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Upgrading only the client without checking broker version compatibility",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Manually setting api.version.request=false in client config, which can cause silent failures",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Update the Kafka client library to match the broker version. For example, if broker is 3.4.0, use kafka-clients 3.4.0 in your project.",
      "success_rate": 0.9,
      "how": "Update the Kafka client library to match the broker version. For example, if broker is 3.4.0, use kafka-clients 3.4.0 in your project.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Set inter.broker.protocol.version in broker config to match the older version if client cannot be upgraded immediately.",
      "success_rate": 0.85,
      "how": "Set inter.broker.protocol.version in broker config to match the older version if client cannot be upgraded immediately.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Update the Kafka client library to match the broker version. For example, if broker is 3.4.0, use kafka-clients 3.4.0 in your project.",
    "Set inter.broker.protocol.version in broker config to match the older version if client cannot be upgraded immediately."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://kafka.apache.org/documentation/#upgrade",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2023-04-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}