...
Eroare Python · Module și fișiere

zipfile.BadZipFile: File is not a zip file

Pe scurt

Fișierul deschis cu zipfile nu e o arhivă ZIP validă: e alt tip de fișier cu extensia .zip (o pagină HTML de eroare, un CSV), e descărcat incomplet sau a fost scris ca text. Verifică primii octeți și sursa fișierului, și testează cu zipfile.is_zipfile() înainte.

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

Ce înseamnă

zipfile.ZipFile(cale) caută la finalul fișierului „cuprinsul” arhivei, o structură specifică formatului ZIP. Dacă nu o găsește, ridică BadZipFile: File is not a zip file. Extensia .zip nu contează: modulul se uită la conținut.

Cauze reale frecvente: ai descărcat fișierul de pe un link care a întors de fapt o pagină HTML (eroare 404, pagină de login, limită de descărcări); descărcarea s-a întrerupt și fișierul e trunchiat; fișierul e alt format (.rar, .7z, .gz) redenumit; sau l-ai „creat” scriind text cu open() în loc să folosești ZipFile(..., "w").

Fișierele .xlsx și .docx sunt tot arhive ZIP, de aceea biblioteci ca openpyxl sau pandas.read_excel pot da aceeași eroare când fișierul Excel e de fapt un .xls vechi, un CSV sau o pagină HTML.

De ce apare: cauzele frecvente

1Arhiva scrisă ca text

Greșit
PYTHON
import zipfile
with open("raport.zip", "w") as f:
    f.write("luna,total\nian,100\n")
zipfile.ZipFile("raport.zip")
Corect
PYTHON
import zipfile
with zipfile.ZipFile("raport.zip", "w") as z:
    z.writestr("raport.csv", "luna,total\nian,100\n")
print(zipfile.ZipFile("raport.zip").namelist())

O arhivă se creează cu ZipFile în modul w; textul scris direct nu are structura ZIP.

2Ai descărcat o pagină HTML

Greșit
PYTHON
import zipfile
open("date.zip", "wb").write(b"<html><body>404 Not Found</body></html>")
zipfile.ZipFile("date.zip")
Corect
PYTHON
import zipfile
open("date.zip", "wb").write(b"<html><body>404 Not Found</body></html>")
if zipfile.is_zipfile("date.zip"):
    print(zipfile.ZipFile("date.zip").namelist())
else:
    print(open("date.zip", "rb").read(15))

is_zipfile verifică fără excepție, iar primii octeți arată ce ai primit de fapt (o arhivă ZIP începe cu PK).

Repară tu

Repară eroarea, direct în pagină

Programul creează o arhivă cu un raport CSV și apoi afișează ce fișiere conține, dar deschiderea arhivei dă zipfile.BadZipFile: File is not a zip file. Repară crearea arhivei ca programul să afișeze ['vanzari.csv'].

Codul care dă eroarea
PYTHON
import zipfile

with open("export.zip", "w", encoding="utf-8") as f:
    f.write("luna,total\nian,1200\nfeb,950\n")

with zipfile.ZipFile("export.zip") as z:
    print(z.namelist())
După reparație, programul afișează
['vanzari.csv']
Indiciu

Arhiva trebuie creată cu zipfile.ZipFile în modul de scriere, iar fișierul din ea adăugat cu writestr.

Alte forme ale mesajului

  • zipfile.BadZipFile: Bad magic number for file header
  • zipfile.BadZipfile: File is not a zip file
  • zipfile.BadZipFile: Truncated file header

Cum o eviți pe viitor

  • La descărcări, verifică codul de răspuns (de exemplu response.raise_for_status() cu requests) și tipul conținutului înainte să salvezi fișierul.
  • Testează fișierul cu zipfile.is_zipfile(cale) înainte să-l deschizi.
  • Creează arhive doar cu zipfile.ZipFile(cale, "w") sau shutil.make_archive.
  • Nu te baza pe extensie: uită-te la primii octeți (PK pentru ZIP, <html pentru o pagină web).

Întrebări frecvente

De ce primesc eroarea la un fișier Excel?

Fișierele .xlsx sunt arhive ZIP. Dacă fișierul e de fapt un .xls vechi, un CSV redenumit sau o pagină HTML exportată, biblioteca nu găsește structura ZIP. Deschide-l într-un editor de text sau verifică primii octeți.

Pot repara o arhivă trunchiată din Python?

De regulă nu. Soluția sigură e să descarci sau să generezi din nou fișierul. Uneltele externe de reparare recuperează uneori o parte din fișiere.

Erori înrudite

← Toate erorile Python

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ță Python de la zero, cu exerciții la fiecare lecție

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