{
  "id": "kafka/unsupported-compression-type",
  "signature": "org.apache.kafka.common.errors.UnsupportedCompressionTypeException: The compression type is not supported.",
  "signature_zh": "org.apache.kafka.common.errors.UnsupportedCompressionTypeException：不支持的压缩类型。",
  "regex": "UnsupportedCompressionTypeException",
  "domain": "kafka",
  "category": "protocol_error",
  "subcategory": null,
  "root_cause": "The broker or client received a message with a compression codec (e.g., lz4, snappy, zstd) that is not enabled or supported in the broker configuration.",
  "root_cause_type": "generic",
  "root_cause_zh": "代理或客户端收到带有压缩编解码器（例如 lz4、snappy、zstd）的消息，该编解码器在代理配置中未启用或不受支持。",
  "versions": [],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Upgrading the client library without changing broker config (e.g., enabling zstd on broker) still fails because the broker rejects unknown compression.",
      "fail_rate": 0.75,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Disabling compression on the producer without fixing the broker may hide the symptom but loses efficiency; the root cause is the broker not supporting the codec.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Enable the compression type in broker's server.properties: `compression.type=producer` (auto-detect) or explicitly set `zstd` if using zstd. Then restart the broker. Example: `echo 'compression.type=zstd' >> config/server.properties && kafka-server-stop.sh && kafka-server-start.sh config/server.properties`.",
      "success_rate": 0.85,
      "how": "Enable the compression type in broker's server.properties: `compression.type=producer` (auto-detect) or explicitly set `zstd` if using zstd. Then restart the broker. Example: `echo 'compression.type=zstd' >> config/server.properties && kafka-server-stop.sh && kafka-server-start.sh config/server.properties`.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Enable the compression type in broker's server.properties: `compression.type=producer` (auto-detect) or explicitly set `zstd` if using zstd. Then restart the broker. Example: `echo 'compression.type=zstd' >> config/server.properties && kafka-server-stop.sh && kafka-server-start.sh config/server.properties`."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://kafka.apache.org/documentation/#compression",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.87,
  "fix_success_rate": 0.85,
  "resolvable": "partial",
  "first_seen": "2024-02-28",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}