zipfile.BadZipFile: File is not a zip file
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
import zipfile
with open("raport.zip", "w") as f:
f.write("luna,total\nian,100\n")
zipfile.ZipFile("raport.zip")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
import zipfile
open("date.zip", "wb").write(b"<html><body>404 Not Found</body></html>")
zipfile.ZipFile("date.zip")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ă 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'].
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())['vanzari.csv']
Indiciu
Arhiva trebuie creată cu zipfile.ZipFile în modul de scriere, iar fișierul din ea adăugat cu writestr.
Reparația
import zipfile
with zipfile.ZipFile("export.zip", "w") as z:
z.writestr("vanzari.csv", "luna,total\nian,1200\nfeb,950\n")
with zipfile.ZipFile("export.zip") as z:
print(z.namelist())De ce merge
Scriind text cu open, fișierul export.zip avea doar conținutul CSV, fără structura unei arhive, iar extensia .zip nu schimbă asta. zipfile.ZipFile(..., "w") creează o arhivă reală, iar writestr adaugă în ea fișierul vanzari.csv cu conținutul dat. La citire, namelist() listează fișierele din arhivă.
Alte forme ale mesajului
zipfile.BadZipFile: Bad magic number for file headerzipfile.BadZipfile: File is not a zip filezipfile.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()curequests) ș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")saushutil.make_archive. - Nu te baza pe extensie: uită-te la primii octeți (
PKpentru ZIP,<htmlpentru 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
FileNotFoundError: [Errno 2] No such file or directory: 'date.txt' Python nu găsește fișierul pe care vrei să-l deschizi: numele e scris greșit sau calea e relativă la alt folder decât cel din care rulezi programul. Verifică numele exact (inclusiv extensia) și folderul curent cu `os.getcwd()`, sau construiește calea pornind de la locul scriptului. UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 15: invalid continuation byte Fișierul (sau datele) nu e salvat în UTF-8, ci în alt encoding, de obicei unul vechi de Windows (`cp1250`, `latin-1`) sau e un Excel salvat ca CSV. Deschide-l cu encoding-ul corect: `open("fisier.csv", encoding="cp1250")`, sau resalvează-l ca UTF-8. ValueError: binary mode doesn't take an encoding argument Ai deschis un fișier în mod binar ("rb", "wb") și i-ai dat și encoding=. În modul binar citești octeți, fără decodare, deci encoding nu are sens. Fie scoți "b" din mod ca să lucrezi cu text, fie scoți encoding și decodezi tu cu .decode("utf-8"). Î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.
