{
  "id": "kafka/unknown-server-exception",
  "signature": "org.apache.kafka.common.errors.UnknownServerException: The server experienced an unexpected error.",
  "signature_zh": "org.apache.kafka.common.errors.UnknownServerException：服务器遇到意外错误。",
  "regex": "org\\.apache\\.kafka\\.common\\.errors\\.UnknownServerException",
  "domain": "kafka",
  "category": "runtime_error",
  "subcategory": null,
  "root_cause": "An internal broker error occurred, often due to a corrupted message or disk I/O failure that the broker cannot classify.",
  "root_cause_type": "generic",
  "root_cause_zh": "内部代理错误发生，通常是由于消息损坏或磁盘 I/O 故障，代理无法分类。",
  "versions": [],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Restarting the broker without checking logs or disk health only delays the error; the underlying corruption persists and will recur.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Increasing replication factor doesn't fix the corrupt data on the affected broker; it just adds replicas that may also encounter the issue.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Check broker logs for detailed stack trace: `grep -i 'UnknownServerException' /var/log/kafka/server.log`. Then run `fsck` on the data directory or replace the disk if bad sectors are detected.",
      "success_rate": 0.7,
      "how": "Check broker logs for detailed stack trace: `grep -i 'UnknownServerException' /var/log/kafka/server.log`. Then run `fsck` on the data directory or replace the disk if bad sectors are detected.",
      "condition": "",
      "sources": []
    },
    {
      "action": "If corruption is isolated to a topic partition, use `kafka-reassign-partitions.sh` to move replicas to a healthy broker and delete the corrupt data directory.",
      "success_rate": 0.8,
      "how": "If corruption is isolated to a topic partition, use `kafka-reassign-partitions.sh` to move replicas to a healthy broker and delete the corrupt data directory.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Check broker logs for detailed stack trace: `grep -i 'UnknownServerException' /var/log/kafka/server.log`. Then run `fsck` on the data directory or replace the disk if bad sectors are detected.",
    "If corruption is isolated to a topic partition, use `kafka-reassign-partitions.sh` to move replicas to a healthy broker and delete the corrupt data directory."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://kafka.apache.org/documentation/#error_unknown_server_exception",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.75,
  "resolvable": "partial",
  "first_seen": "2024-03-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}