{
  "id": "kafka/unsupported-version-join-group",
  "signature": "org.apache.kafka.common.errors.UnsupportedVersionException: The broker does not support the group protocol version required by the consumer",
  "signature_zh": "org.apache.kafka.common.errors.UnsupportedVersionException: 代理不支持消费者所需的组协议版本",
  "regex": "UnsupportedVersionException.*group protocol version",
  "domain": "kafka",
  "category": "protocol_error",
  "subcategory": null,
  "root_cause": "Consumer requests a group protocol version (e.g., 2) that broker does not support due to version mismatch between consumer and broker.",
  "root_cause_type": "generic",
  "root_cause_zh": "消费者请求的组协议版本（例如2）代理不支持，原因是消费者和代理之间的版本不匹配。",
  "versions": [
    {
      "version": "3.0.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.3.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.6.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Classic protocol may not be supported by older brokers; error persists if broker version is too low.",
      "fail_rate": 0.75,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Consumer version mismatch with broker causes unsupported version errors; both must be compatible.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Inter-broker protocol version affects broker communication, not consumer group protocol; does not fix consumer-side error.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Set consumer's 'group.protocol' to 'classic' and ensure broker supports classic protocol (Kafka 3.0+).",
      "success_rate": 0.85,
      "how": "Set consumer's 'group.protocol' to 'classic' and ensure broker supports classic protocol (Kafka 3.0+).",
      "condition": "",
      "sources": []
    },
    {
      "action": "Upgrade broker to version that supports the consumer's group protocol (e.g., upgrade to 3.6 for consumer protocol v2).",
      "success_rate": 0.95,
      "how": "Upgrade broker to version that supports the consumer's group protocol (e.g., upgrade to 3.6 for consumer protocol v2).",
      "condition": "",
      "sources": []
    },
    {
      "action": "Downgrade consumer client library to match broker version (e.g., use kafka-clients 3.3.0 with broker 3.3.0).",
      "success_rate": 0.9,
      "how": "Downgrade consumer client library to match broker version (e.g., use kafka-clients 3.3.0 with broker 3.3.0).",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "将消费者的 'group.protocol' 设置为 'classic'，并确保代理支持经典协议（Kafka 3.0+）。",
    "升级代理到支持消费者组协议的版本（例如，升级到3.6以支持消费者协议v2）。",
    "降级消费者客户端库以匹配代理版本（例如，使用kafka-clients 3.3.0与代理3.3.0）。"
  ],
  "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.84,
  "fix_success_rate": 0.88,
  "resolvable": "true",
  "first_seen": "2024-03-20",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}