{
  "id": "grpc/compression-algorithm-not-installed",
  "signature": "UNIMPLEMENTED: grpc: Decompressor is not installed for algorithm gzip",
  "signature_zh": "UNIMPLEMENTED: grpc: 未安装算法 gzip 的解压器",
  "regex": "UNIMPLEMENTED: grpc: Decompressor is not installed for algorithm \\w+",
  "domain": "grpc",
  "category": "encoding_error",
  "subcategory": null,
  "root_cause": "The gRPC client or server received a message compressed with an algorithm for which no decompressor is registered, often due to missing build of compression library.",
  "root_cause_type": "generic",
  "root_cause_zh": "gRPC 客户端或服务器收到使用未注册解压器的算法压缩的消息，通常由于缺少压缩库的构建。",
  "versions": [
    {
      "version": "gRPC C++ 1.62.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "gRPC Python 1.64.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "gRPC Go 1.65.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Reinstall gRPC without any compression flags",
      "why_fails": "Default install may not include gzip support; need explicit build flag.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "Disable compression on the server only",
      "why_fails": "Client may still send compressed messages if not configured to avoid it.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    },
    {
      "action": "Set environment variable to force plain text mode",
      "why_fails": "gRPC compression is negotiated per call; env vars don't override protocol.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Rebuild gRPC with compression support: In C++, set `-DgRPC_BUILD_CODEC=ON` and `export GRPC_DEFAULT_SSL_ROOTS_FILE_PATH=/etc/ssl/certs/ca-certificates.crt` then recompile",
      "success_rate": 0.85,
      "how": "Rebuild gRPC with compression support: In C++, set `-DgRPC_BUILD_CODEC=ON` and `export GRPC_DEFAULT_SSL_ROOTS_FILE_PATH=/etc/ssl/certs/ca-certificates.crt` then recompile",
      "condition": "",
      "sources": []
    },
    {
      "action": "In gRPC Python, install with extra compression: `pip install grpcio[compression]` or explicitly import `grpc._compression` and register `grpc.Compression.Gzip`",
      "success_rate": 0.9,
      "how": "In gRPC Python, install with extra compression: `pip install grpcio[compression]` or explicitly import `grpc._compression` and register `grpc.Compression.Gzip`",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "重新构建 gRPC 并启用压缩支持：在 C++ 中，设置 `-DgRPC_BUILD_CODEC=ON` 和 `export GRPC_DEFAULT_SSL_ROOTS_FILE_PATH=/etc/ssl/certs/ca-certificates.crt` 然后重新编译",
    "在 gRPC Python 中，安装带额外压缩的版本：`pip install grpcio[compression]` 或显式导入 `grpc._compression` 并注册 `grpc.Compression.Gzip`"
  ],
  "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.83,
  "fix_success_rate": 0.85,
  "resolvable": "true",
  "first_seen": "2024-05-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}