Open-XML-SDK 中处理 Word 文档时流操作的最佳实践

2025-06-15 13:47:21作者：霍妲思

在使用 Open-XML-SDK 处理 Word 文档时，开发者经常会遇到文档流操作的问题。本文将通过一个典型示例，深入分析在 .NET Framework 4.8 和 .NET 8.0 环境下处理 Word 文档时的差异，并提供正确的解决方案。

问题现象

当开发者尝试在 .NET Framework 4.8 环境下使用 Open-XML-SDK 创建并修改 Word 文档时，可能会遇到生成的文档损坏的情况。具体表现为使用 7zip 解压生成的 docx 文件时，会出现"data error: word_rels\document.xml.rels"的错误提示。

问题代码分析

以下是典型的有问题代码示例：

var m_stream = new MemoryStream();
GenerateDocx(m_stream);
m_stream.Position = 0;

var mydoc = WordprocessingDocument.Open(m_stream, true);
var mainPart = mydoc.MainDocumentPart!;

var alternativeFormatImportPart = mainPart.AddAlternativeFormatImportPart(AlternativeFormatImportPartType.Html);
alternativeFormatImportPart.FeedData(new MemoryStream(new UTF8Encoding(true).GetBytes("<html>Hello</html>")));
mydoc.Save();

using var fs = new FileStream("result.docx", FileMode.Create, FileAccess.ReadWrite);
m_stream.Position = 0;
m_stream.CopyTo(fs);

这段代码在 .NET 8.0 环境下可以正常工作，但在 .NET Framework 4.8 环境下会导致生成的文档损坏。

根本原因

问题的核心在于文档流的管理方式。Open-XML-SDK 在处理 Word 文档时，需要确保所有对文档的修改都已完成并且正确保存后，才能安全地访问或复制底层流数据。

在 .NET Framework 4.8 和 .NET 8.0 中，垃圾回收和资源清理的行为有所不同，导致在 .NET 8.0 中看似"工作"的代码，在 .NET Framework 4.8 中却出现问题。

正确解决方案

正确的做法是使用 using 语句确保 WordprocessingDocument 对象被正确释放，所有修改都已刷新到底层流中：

var m_stream = new MemoryStream();
GenerateDocx(m_stream);
m_stream.Position = 0;

// 使用 using 确保文档正确处理
using (var mydoc = WordprocessingDocument.Open(m_stream, true))
{
    var mainPart = mydoc.MainDocumentPart!;
    var alternativeFormatImportPart = mainPart.AddAlternativeFormatImportPart(AlternativeFormatImportPartType.Html);
    alternativeFormatImportPart.FeedData(new MemoryStream(new UTF8Encoding(true).GetBytes("<html>Hello</html>")));
    mydoc.Save();
}

// 文档处理完成后再操作流
using var fs = new FileStream("result.docx", FileMode.Create, FileAccess.ReadWrite);
m_stream.Position = 0;
m_stream.CopyTo(fs);