SharpZipLib解压密码保护ZIP报密码无效如何解决

使用SharpZipLib实现ZIP文件解压功能，实现代码如下：

using (var fsInput = File.OpenRead(zipFile))
using (var zf = new ZipFile(fsInput)) {
    zf.Password = password;
            
    foreach (ZipEntry zipEntry in zf) {
        if (!zipEntry.IsFile) {
            // 忽略目录
            continue;
        }
                
        var entryFileName = zipEntry.Name;
        // 自定义输出路径
        var fullZipToPath = Path.Combine(Settings.Default.ConsTemp, entryFileName);
        // 4K缓冲区为最优大小
        var buffer = new byte[4096];

        using (var zipStream = zf.GetInputStream(zipEntry))
        using (Stream fsOutput = File.Create(fullZipToPath)) {
            StreamUtils.Copy(zipStream, fsOutput, buffer);
        }
    }
}

运行上述代码时始终抛出Invalid password异常，但使用完全相同的密码通过Windows系统自带解压功能操作时，可正常解压该ZIP文件。

• 编码不匹配：中文Windows环境下，系统自带解压功能默认使用GBK编码处理密码与文件名，而SharpZipLib默认使用UTF-8编码。如果密码包含中文、全角符号等非ASCII字符，编码不一致会直接导致密码校验失败。
• 加密算法兼容问题：Windows自带解压支持WinZip AES-128/256等强加密标准，旧版本SharpZipLib默认仅支持传统ZipCrypto弱加密算法，遇到AES加密的压缩包时会直接抛出密码错误异常。
• 密码作用域问题：部分SharpZipLib版本中，仅给ZipFile实例全局设置密码无法覆盖所有压缩条目，部分带独立加密标记的文件条目未读取到密码配置，会触发密码校验失败。

1. 配置匹配的编码
   如果运行环境为.NET Core/.NET 5+，首先安装System.Text.Encoding.CodePages包，在程序启动时注册GBK编码支持：

   Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
   

   初始化ZipFile实例时显式指定GBK编码，和Windows系统默认行为对齐：

   using (var fsInput = File.OpenRead(zipFile))
   using (var zf = new ZipFile(fsInput, Encoding.GetEncoding("GBK")))
   {
       // 后续逻辑
   }
   

2. 升级依赖版本
   将SharpZipLib升级到最新稳定版，新版本已原生支持WinZip AES加密标准，可直接兼容Windows资源管理器生成的AES加密ZIP包，无需额外配置。
3. 给单个压缩条目单独设置密码
   遍历压缩条目时，给每个文件条目单独赋值密码，覆盖全局配置不生效的场景：

   foreach (ZipEntry zipEntry in zf) {
       if (!zipEntry.IsFile) {
           continue;
       }
       zipEntry.Password = password; // 单条目设置密码
       // 后续解压逻辑不变
   }
   

4. 基础校验
   排查传入的密码字符串是否存在前后多余空格、不可见换行/制表符，这类字符在手动复制密码时很容易被带入，也会导致密码校验失败。

内容的提问来源于stack exchange，提问作者BennoDual