Skip to Content
DevelopersError CodesCodesTerrainChunk decompress failed

Chunk decompress failed

Code

TERRAIN/CHUNK_FAILED_TO_DECOMPRESS

What it means

Chunk bytes were fetched, but decompression failed (gzip/snappy/transport mismatch or corrupted payload).

When it happens

  • Decompression fails (e.g. invalid gzip header, corrupted payload).

Typical scenarios:

  • Payload is already decompressed by an HTTP client (double-decompress)
  • Content-Encoding headers don’t match the stored bytes
  • Corrupted bytes in storage/cache

How to handle

  • Log meta.storagePath/meta.key and whether gzip was detected.
  • Consider invalidating the affected cache entry and regenerating the chunk if possible.
Last updated on
Docsv1.0.10