{
  "id": "grpc/compressor-not-installed",
  "signature": "UNIMPLEMENTED: grpc: Decompressor is not installed for gzip",
  "signature_zh": "未实现：gRPC：未安装 gzip 解压缩器",
  "regex": "UNIMPLEMENTED: grpc: Decompressor is not installed for gzip",
  "domain": "grpc",
  "category": "encoding_error",
  "subcategory": null,
  "root_cause": "The gRPC client or server does not have the required compression library registered to handle gzip-encoded messages.",
  "root_cause_type": "generic",
  "root_cause_zh": "gRPC 客户端或服务器未注册处理 gzip 编码消息所需的压缩库。",
  "versions": [
    {
      "version": "grpc-go v1.56.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "grpc-java v1.58.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "grpc-python v1.60.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Reinstall grpc package with pip install --upgrade grpcio",
      "why_fails": "The issue is not package version but missing compression registration; reinstalling doesn't register the decompressor.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "Set environment variable GRPC_DEFAULT_SSL_ROOTS_FILE_PATH",
      "why_fails": "This env var controls SSL roots, not compression codecs; completely unrelated.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Register the gzip decompressor in gRPC options: for Python, use `grpc.insecure_channel('target', options=[('grpc.enable_decompression', True)])` and ensure `grpc` is installed with compression support.",
      "success_rate": 0.75,
      "how": "Register the gzip decompressor in gRPC options: for Python, use `grpc.insecure_channel('target', options=[('grpc.enable_decompression', True)])` and ensure `grpc` is installed with compression support.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Disable compression on the client side by setting `grpc.default_compression_algorithm` to 'identity' in channel options: `options=[('grpc.default_compression_algorithm', 0)]`.",
      "success_rate": 0.85,
      "how": "Disable compression on the client side by setting `grpc.default_compression_algorithm` to 'identity' in channel options: `options=[('grpc.default_compression_algorithm', 0)]`.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "在 gRPC 选项中注册 gzip 解压缩器：对于 Python，使用 `grpc.insecure_channel('target', options=[('grpc.enable_decompression', True)])` 并确保已安装支持压缩的 `grpc`。",
    "在客户端禁用压缩：在通道选项中设置 `grpc.default_compression_algorithm` 为 'identity'：`options=[('grpc.default_compression_algorithm', 0)]`。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://grpc.io/docs/guides/compression/",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-03-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}