zip 文件无法单靠 zipexception 或返回值区分密码错误与损坏，因 java 原生不支持加密，需结合库类型、异常消息、主动探测：zip4j 依赖异常关键词；zipfile 用于排除非加密问题；py7zr 提供明确密码/损坏信号。
Zip 文件在脚本中无法单靠 ZipException 或返回值直接区分“密码错误”和“文件损坏”，因为标准 Java java.util.zip 根本不支持加密 ZIP，所有涉及密码的场景必然依赖第三方库（如 zip4j、commons-compress），而不同库的异常行为和返回信号差异很大。精准判定必须结合库类型 + 异常类型 + 关键消息特征 + 主动探测逻辑，不能只看“有没有异常”。
以下是实用、可落地的判定策略，按常见库分开展示：
用 zip4j 判定密码错误 vs 文件损坏
zip4j 是最常用的加密 ZIP 处理库，它把两类问题暴露得相对清晰：
-
密码错误 时典型表现：
- 调用
zipFile.extractAll(...)前未调用setPassword(...)→ 抛ZipException: Unsupported Zip Version [20]或CRC mismatch - 密码错误但已设密码 → 抛
ZipException: Invalid password for file ...（消息含 invalid password、wrong password） - 中文密码编码错（如用 UTF-8 解 GBK 存的密码）→ 抛
ZipException: invalid stored block lengths或java.lang.ArrayIndexOutOfBoundsException（底层解密失败）
- 调用
-
文件损坏 时典型表现：
-
ZipFile(file)构造即失败 →ZipException: error in opening zip file（配合file命令或系统解压验证后基本可确认） -
zipFile.getFileHeaders()返回空或抛异常 → 结构层面损坏（中央目录读取失败） -
zipFile.testFileHeaders()返回false或抛ZipException: invalid CEN header→ 目录表校验失败
-
✅ 实操建议：
# Python 调用 zip4j 的 Java 逻辑（通过 subprocess 或 JPype）不推荐；更推荐用 Python 生态统一处理
# 但若必须用 zip4j，务必捕获并检查异常消息：
try:
zip_file = ZipFile("archive.zip")
zip_file.setPassword(Password("123456"))
zip_file.extractAll("/output")
except ZipException as e:
msg = str(e).lower()
if "password" in msg or "wrong" in msg or "invalid" in msg and "password" in msg:
print("判定：密码错误")
elif "cen" in msg or "central directory" in msg or "header" in msg and "invalid" in msg:
print("判定：文件结构损坏")
elif "crc" in msg or "mismatch" in msg and "password" not in msg:
print("判定：部分文件数据损坏（可能可跳过）")
用 Python 原生 zipfile + 主动探测法（无第三方依赖）
zipfile 本身不支持密码，但它能帮你排除密码问题——如果 zipfile.is_zipfile() 返回 False 或 ZipFile(...) 构造失败，那根本不是合法 ZIP，谈不上密码。
-
✅ 先做基础格式验证：
import zipfile def diagnose_zip(filepath): # 步骤1：魔数检查（快且可靠） with open(filepath, "rb") as f: if f.read(4) != b'PK\x03\x04': return "非 ZIP 格式（可能是损坏或伪造）" # 步骤2：尝试打开（触发中央目录解析） try: zf = zipfile.ZipFile(filepath) # 步骤3：强制校验所有条目 CRC（慢但准） bad_file = zf.testzip() if bad_file is not None: return f"文件损坏：{bad_file} CRC 校验失败" return "ZIP 完整，无加密（可用 zipfile 直接解压）" except zipfile.BadZipFile: return "ZIP 文件头或中央目录损坏" except OSError as e: if "Truncated" in str(e): return "文件截断（下载不完整）" return "I/O 错误（磁盘/权限问题）" except Exception as e: # 兜底：其他异常大概率是加密 ZIP 被 zipfile 碰到（抛 RuntimeError 或 NotImplementedError） if "encrypted" in str(e).lower() or "password" in str(e).lower(): return "疑似加密 ZIP（需用 zip4j 或 py7zr 等支持密码的库）" return f"未知异常：{type(e).__name__}"
用 py7zr 统一处理 ZIP/RAR/7z（推荐用于生产脚本）
py7zr 对加密检测更友好，且能明确返回是否需要密码：
import py7zr
def check_encrypted_and_integrity(filepath):
try:
# py7zr 支持 ZIP，且能主动探测密码需求
with py7zr.SevenZipFile(filepath, mode='r') as archive:
# 若文件加密，此处会直接抛 PasswordRequired
return {"status": "ok", "encrypted": False, "reason": None}
except py7zr.PasswordRequired:
return {"status": "encrypted", "encrypted": True, "reason": "密码必需"}
except py7zr.Bad7zFile:
return {"status": "corrupted", "encrypted": False, "reason": "7z 头部损坏"}
except Exception as e:
msg = str(e).lower()
if "crc" in msg or "checksum" in msg:
return {"status": "corrupted", "encrypted": False, "reason": "数据块校验失败"}
elif "password" in msg or "wrong" in msg:
return {"status": "encrypted", "encrypted": True, "reason": "密码错误"}
else:
return {"status": "unknown", "encrypted": False, "reason": msg}
⚠️ 注意：
py7zr解 ZIP 时对某些老版加密 ZIP（尤其是 WinRAR 生成的）兼容性不如 zip4j，但它胜在异常语义清晰、不依赖 JVM、跨平台一致。
小结：怎么才算“精准判定”
- 不依赖单一异常类，要结合异常类型 + 消息关键词 + 主动探测结果
- 密码错误一定发生在“已知加密 ZIP”的前提下；若连 ZIP 格式都不满足，优先查损坏
- 对脚本来说，最稳路径是：
file 魔数 → zipfile.is_zipfile → zipfile testzip → 若失败再试 py7zr/pyminizip → 最后 fallback 到 zip4j（Java 环境）
不复杂但容易忽略。
