如何避免使用System.IO.Compression时随机出现的InvalidDataException

问题核心原因 #

这类随机异常（部分图片显示异常、无图抛出System.IO.InvalidDataException、像素偏移）几乎都是流生命周期管理不当或线程安全问题导致，而非普遍的框架已知bug，具体拆解：

1. 流提前释放导致的异步加载失败
   WPF的BitmapImage默认是异步加载流数据的，如果从ZipArchive中获取的文件流在BitmapImage完成加载前就被释放（比如包裹在using块中，块结束后流被自动关闭），就会出现随机的读取不完整：

• 若流刚好在加载到一半时被释放，会出现图片底部像素偏移；
• 若流在加载前就被释放，会直接抛出InvalidDataException（解压过程中流数据缺失）。

2. 压缩流的线程安全冲突
   System.IO.Compression.InflaterZlib的实例并非线程安全，如果你的代码中存在多线程复用同一个ZipArchive、Inflater或流对象，并发的解压操作会干扰数据读取逻辑，引发随机的异常。

3. 异步加载的竞态条件
   FlowDocument中的Image控件加载逻辑是异步的，若多个图像的流处理逻辑未做隔离（比如共享同一个流对象），会出现数据混乱，导致部分图片加载失败。

针对性解决办法 #

1. 确保流数据被完全加载到内存，脱离原流依赖 #

将ZIP中的图片流复制到独立的MemoryStream，并设置BitmapCacheOption.OnLoad让BitmapImage立即加载数据，避免原流被释放的影响：

// 假设zipFileStream是已打开的ZIP文件流
using (var zipArchive = new ZipArchive(zipFileStream, ZipArchiveMode.Read))
{
    foreach (var entry in zipArchive.Entries.Where(e => e.Name.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)))
    {
        using (var entryStream = entry.Open())
        {
            // 复制流到MemoryStream，确保数据独立
            var imageMs = new MemoryStream();
            entryStream.CopyTo(imageMs);
            imageMs.Position = 0;

            var bitmap = new BitmapImage();
            bitmap.BeginInit();
            bitmap.StreamSource = imageMs;
            bitmap.CacheOption = BitmapCacheOption.OnLoad; // 立即加载到内存，不再依赖流
            bitmap.EndInit();

            var imageControl = new Image { Source = bitmap, Margin = new Thickness(5) };
            flowDocument.Blocks.Add(new Paragraph(new InlineUIContainer(imageControl)));
        }
    }
}

2. 隔离每个图像的加载数据源 #

不要在多个图像加载逻辑中复用同一个ZipArchive、流对象或Inflater实例，确保每个图片都使用独立的流副本，避免并发操作干扰。

3. 确保UI操作在主线程执行 #

WPF的UI控件（包括FlowDocument、Image）并非线程安全，所有创建、修改控件的操作必须在UI线程执行。如果需要后台读取ZIP文件，读取完成后通过Dispatcher.Invoke切换到UI线程创建控件。

关于框架bug的说明 #

目前没有公开的、普遍存在的WPF或System.IO.Compression框架bug会导致这类随机问题。如果升级到最新的.NET Framework/.NET版本后问题仍存在，大概率还是代码中的流管理或线程同步逻辑有疏漏。

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