C#使用OpenXML合并两个Docx模板为单个Docx文件的异常排查

问题成因 #

两个DOCX文件的所有节、正文、页眉页脚部件完全可以完整合并到同一个新文档中。你遇到的Only one instance of the type is allowed for this parent报错，核心原因是当前批量添加部件的逻辑不符合OpenXML的部件规则：

• WordprocessingDocument根节点下的部分全局部件存在单实例限制，比如MainDocumentPart、CoreFilePropertiesPart、WebSettingsPart这类全局生效的部件，同类型只允许存在一个
• 新建空白DOCX时，OpenXML SDK会自动生成一套默认的全局部件，你后续无差别批量追加两个源文档的所有根部件，相当于重复添加了多份同类型的全局唯一部件，直接触发异常
• 直接复用源文档的RelationshipId添加部件还会导致部件引用关系错乱，即便绕过报错也会出现页眉页脚丢失、样式失效、图片无法显示的问题

正确实现步骤 #

• 初始化目标文档时，先清理默认生成的冗余全局部件，选择第一个信头模板的全局部件作为目标文档的基础全局部件，不要重复添加第二个文档的同类型全局部件
• 导入信头模板的关联资源：把信头里的页眉、页脚、主题、字体表、编号定义这类和信头绑定的部件导入目标文档，重新生成新的关系ID，修正信头节属性（sectPr）里对页眉页脚的引用ID，把信头的正文内容追加到目标文档的MainDocumentPart中
• 导入正文文档的内容：跳过正文文档里的全局单实例部件，只导入正文内容、正文用到的图片、嵌入对象、自定义样式等专属资源部件，如果正文有独立的节配置，同步导入对应节关联的页眉页脚部件，修正引用关系后把正文内容追加到目标文档信头内容的后方
• 拼接位置插入正确的分节符：如果需要保留信头和正文各自的节属性（比如正文要换页眉、改页边距），就在两段内容中间插入下一页分节符；如果全文档统一使用信头的页眉页脚，就删掉正文文档末尾自带的节结束标记，避免产生多余空白页。

参考实现代码 #

using (WordprocessingDocument letterDoc = WordprocessingDocument.Open(letterHeadPath, false))
using (WordprocessingDocument bodyDoc = WordprocessingDocument.Open(bodyContentPath, false))
using (WordprocessingDocument destDoc = WordprocessingDocument.Create(mergedPath, WordprocessingDocumentType.Document))
{
    // 初始化目标文档主部件，以信头模板的全局配置为基础
    MainDocumentPart destMain = destDoc.AddMainDocumentPart();
    // 复制信头关联的样式、页眉页脚、主题等基础部件
    foreach (var part in letterDoc.MainDocumentPart.Parts)
    {
        destMain.AddPart(part.OpenXmlPart);
    }
    // 写入信头正文内容
    using (StreamWriter sw = new StreamWriter(destMain.GetStream(FileMode.Create)))
    {
        sw.Write(letterDoc.MainDocumentPart.Document.OuterXml);
    }
    // 处理正文内容，跳过全局单实例部件
    var bodyContent = bodyDoc.MainDocumentPart.Document.Body;
    // 全文档复用信头页眉页脚时可移除正文末尾自带的节属性，需保留独立节配置则替换为插入分节符逻辑
    bodyContent.Elements<SectionProperties>().LastOrDefault()?.Remove();
    // 导入正文专属的图片、嵌入对象等资源，自动生成新的关系ID避免冲突
    foreach (var part in bodyDoc.MainDocumentPart.Parts)
    {
        // 跳过已经从信头导入的全局单实例部件
        if (part.OpenXmlPart is StylesPart or NumberingDefinitionsPart or FontTablePart)
            continue;
        destMain.AddPart(part.OpenXmlPart);
    }
    // 追加正文内容到目标文档末尾并保存
    destMain.Document.Body.Append(bodyContent.ChildElements);
    destMain.Document.Save();
}

注意：如果正文文档有独立的页眉页脚、页边距等节配置，不要直接移除正文的节属性，需要在信头内容末尾插入分节符，单独导入正文对应节的页眉页脚部件并修正引用ID即可。

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