...
Eroare Java · Fluxuri I/O, codificări și compresie

java.util.zip.ZipException: Not in GZIP format

Pe scurt

GZIPInputStream a primit date care nu sunt comprimate gzip (lipsesc primii octeți 1F 8B), de exemplu un răspuns HTTP necomprimat sau un fișier text. Verifică dacă datele chiar sunt gzip (antetul Content-Encoding sau primii doi octeți) și decomprimă doar atunci.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Orice flux gzip începe cu octeții 1F 8B. new GZIPInputStream(in) citește antetul chiar în constructor și, dacă nu găsește acești octeți, aruncă ZipException: Not in GZIP format.

Cazuri tipice:

  • ai cerut unui server un răspuns comprimat (Accept-Encoding: gzip), dar serverul a trimis textul necomprimat, iar codul decomprimă orice răspuns;
  • un fișier cu extensia .gz nu e de fapt comprimat, sau e un .zip (care are alt format și se citește cu ZipInputStream);
  • datele au fost comprimate și apoi codificate în Base64, iar tu ai uitat să le decodezi întâi.

Dacă antetul e corect, dar arhiva e tăiată, eroarea apare mai târziu, la citire: EOFException: Unexpected end of ZLIB input stream.

De ce apare: cauzele frecvente

1Răspuns necomprimat decomprimat oricum

Greșit
JAVA
InputStream corp = new GZIPInputStream(raspuns.body());
Corect
JAVA
boolean gzip = raspuns.headers().firstValue("Content-Encoding")
    .map(v -> v.equalsIgnoreCase("gzip")).orElse(false);
InputStream corp = gzip ? new GZIPInputStream(raspuns.body()) : raspuns.body();

Decomprimi doar când serverul spune că a comprimat răspunsul.

2Verificare după primii doi octeți

Greșit
JAVA
byte[] text = new GZIPInputStream(new ByteArrayInputStream(date)).readAllBytes();
Corect
JAVA
boolean gzip = date.length > 1 && (date[0] & 0xFF) == 0x1F && (date[1] & 0xFF) == 0x8B;
byte[] text = gzip
    ? new GZIPInputStream(new ByteArrayInputStream(date)).readAllBytes()
    : date;

Octeții 1F 8B sunt semnătura formatului gzip.

3Arhivă .zip citită ca gzip

Greșit
JAVA
new GZIPInputStream(new FileInputStream("export.zip"));
Corect
JAVA
ZipInputStream zip = new ZipInputStream(new FileInputStream("export.zip"));
ZipEntry intrare = zip.getNextEntry();

.zip e o arhivă cu mai multe fișiere și semnătura 50 4B (PK); se citește cu ZipInputStream.

Repară tu

Repară eroarea, direct în pagină

Programul decomprimă orice răspuns primit de la un API, dar răspunsul a venit necomprimat și programul se oprește cu ZipException: Not in GZIP format. Verifică primii doi octeți (0x1F, 0x8B) și decomprimă doar dacă datele sunt gzip, ca programul să afișeze Raspuns: id=15;status=livrat.

Codul care dă eroarea
JAVA
import java.io.*;
import java.nio.charset.StandardCharsets;
import java.util.zip.GZIPInputStream;

public class Main {
    public static void main(String[] args) throws IOException {
        byte[] date = "id=15;status=livrat".getBytes(StandardCharsets.UTF_8);
        byte[] corp = new GZIPInputStream(new ByteArrayInputStream(date)).readAllBytes();
        System.out.println("Raspuns: " + new String(corp, StandardCharsets.UTF_8));
    }
}
După reparație, programul afișează
Raspuns: id=15;status=livrat
Indiciu

boolean gzip = (date[0] & 0xFF) == 0x1F && (date[1] & 0xFF) == 0x8B;

Alte forme ale mesajului

  • java.io.EOFException: Unexpected end of ZLIB input stream
  • java.util.zip.ZipException: invalid stored block lengths
  • java.util.zip.DataFormatException: incorrect header check

Cum o eviți pe viitor

  • Lasă clientul HTTP să trateze compresia sau verifică antetul Content-Encoding înainte de a decomprima.
  • Când citești fișiere, verifică semnătura (primii octeți), nu doar extensia.
  • Păstrează ordinea inversă la decodare: dacă ai comprimat și apoi ai codificat Base64, întâi decodezi Base64, apoi decomprimi.
  • La scriere, cheamă finish() sau close() pe GZIPOutputStream, altfel arhiva rămâne incompletă.

Întrebări frecvente

Care e diferența dintre gzip și zip?

Gzip comprimă un singur flux de date (de exemplu un fișier .gz sau un răspuns HTTP). Zip e o arhivă care poate conține mai multe fișiere și directoare. În Java, primul se citește cu GZIPInputStream, al doilea cu ZipInputStream sau ZipFile.

Ce înseamnă incorrect header check?

Apare la Inflater sau InflaterInputStream când datele nu au antetul zlib, de exemplu pentru că sunt gzip (cu antet propriu) sau date brute deflate. Clasa trebuie să se potrivească formatului.

Erori înrudite

← Toate erorile Java

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.