java.util.zip.ZipException: Not in GZIP format
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
.gznu e de fapt comprimat, sau e un.zip(care are alt format și se citește cuZipInputStream); - 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
InputStream corp = new GZIPInputStream(raspuns.body());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
byte[] text = new GZIPInputStream(new ByteArrayInputStream(date)).readAllBytes();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
new GZIPInputStream(new FileInputStream("export.zip"));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ă 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.
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));
}
}Raspuns: id=15;status=livrat
Indiciu
boolean gzip = (date[0] & 0xFF) == 0x1F && (date[1] & 0xFF) == 0x8B;
Reparația
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);
boolean gzip = date.length > 1 && (date[0] & 0xFF) == 0x1F && (date[1] & 0xFF) == 0x8B;
byte[] corp = gzip
? new GZIPInputStream(new ByteArrayInputStream(date)).readAllBytes()
: date;
System.out.println("Raspuns: " + new String(corp, StandardCharsets.UTF_8));
}
}De ce merge
Constructorul GZIPInputStream citește imediat antetul și cere ca primii octeți să fie 1F 8B. Textul începe cu i (0x69), deci nu e gzip. Verificând semnătura, programul decomprimă doar datele care chiar sunt comprimate, iar textul simplu e folosit direct. & 0xFF transformă octetul cu semn din Java în valoarea 0–255, ca să poată fi comparat cu 0x8B.
Alte forme ale mesajului
java.io.EOFException: Unexpected end of ZLIB input streamjava.util.zip.ZipException: invalid stored block lengthsjava.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()sauclose()peGZIPOutputStream, 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
java.io.EOFException Ai cerut să citești mai multe date decât există în flux: de exemplu readInt() după ce s-au terminat octeții, sau readObject() după ultimul obiect. Scrie la început câte elemente urmează și citește exact atâtea, ori tratează EOFException ca sfârșit normal. java.io.StreamCorruptedException: invalid stream header: 436F6D61 ObjectInputStream a primit date care nu au fost scrise cu ObjectOutputStream: text, JSON, un fișier gol sau alt format. Primii 4 octeți din mesaj (în hex) arată ce era de fapt acolo. Citește datele cu metoda potrivită formatului sau scrie-le cu ObjectOutputStream. java.lang.IllegalArgumentException: Illegal base64 character 2d Base64.getDecoder() a întâlnit un caracter care nu face parte din alfabetul Base64 standard; 2d e codul hexazecimal pentru -, iar 5f pentru _, adică text encodat în varianta URL-safe (ca în tokenurile JWT). Folosește Base64.getUrlDecoder() sau, pentru spații și rânduri noi, getMimeDecoder(). Î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.
