.NET 6插入Word AltChunk后出现不可读内容的问题排查求助

我用.NET 6开发了一个小工具，功能是替换Word文档中的关键字，部分关键字会通过AltChunk替换成其他Word文件的内容。现在遇到一个问题：

• 在文件A中插入同一个AltChunk1，输出文件能正常打开
• 但在文件B中插入同一个AltChunk1，用Word打开会提示发现不可读内容
• 文件B搭配其他AltChunk文件（甚至是修剪后的同一份文件）时，部分场景能正常工作

尝试用OpenXML生产力工具对比文件，但遇到瓶颈：

• 文件A和B差异太多，没法定位原因
• 两者插入AltChunk的位置完全一致
• 对比异常输出文件和Word修复后的文件时，Word会直接合并AltChunk内容，无法有效对比

核心代码 #

以下是创建AltChunk并替换关键字的核心代码（包含处理关键字跨多个Run的场景）：

internal static void MergeOutSideDocument(string key, string filePath, IEnumerable<string> outsideDocs)
{
    if (string.IsNullOrEmpty(key)) throw new ArgumentException("Cannot replace empty key.");
    if (!File.Exists(filePath) || outsideDocs.Any(path => !File.Exists(path))) throw new FileNotFoundException();

    using WordprocessingDocument doc = WordprocessingDocument.Open(filePath, true);
    List<OpenXmlElement> altChunks = new();
    foreach (var outsideDoc in outsideDocs)
    {
        var existingIds = doc.MainDocumentPart.Document.Body.Descendants<AltChunk>();
        string altChunkId = "AltChunkId" + DateTime.Now.Ticks.ToString();
        MainDocumentPart mainPart = doc.MainDocumentPart;
        AlternativeFormatImportPart chunk = mainPart.AddAlternativeFormatImportPart(
            AlternativeFormatImportPartType.WordprocessingML, altChunkId);
        using (FileStream fileStream = File.Open(outsideDoc, FileMode.Open))
            chunk.FeedData(fileStream);
        altChunks.Add(new AltChunk()
        {
            Id = altChunkId
        });
        inMemoryAltChunkIds.Add(altChunkId);
    }

    var body = doc.MainDocumentPart.Document.Body;
    SetElementForKey(key, altChunks,
        body.Descendants<Paragraph>().First(par => par.Contains(key)),
        body);
}

private static void SetElementForKey(string key, List<OpenXmlElement> replacements, OpenXmlElement el, Body body)
{
    List<Run> previousRuns = new();
    if (el?.InnerText.Contains(key) != true) return;

    for (int i = 0; i <= el.Descendants<Run>().Count(); i++)
    {
        var innerText = string.Join("", previousRuns.Select(r => r.InnerText));
        if (innerText.Contains(key))
        {
            var usedRuns = GetRequiredRunsForText(previousRuns, key);
            var firstRun = usedRuns.First();
            MergeRunsWithKey(key, usedRuns, firstRun);
            var usedRun = usedRuns.First();
            var firstPart = usedRun.InnerText.IndexOf(key) != -1 ? usedRun.InnerText[..usedRun.InnerText.IndexOf(key)] : "";
            ReplaceText(key, "", usedRun);
            foreach (var replacement in replacements)
                el.Parent.InsertAfter(replacement, el);
            if (string.IsNullOrEmpty(usedRun.InnerText)) usedRun.Remove();
            if (string.IsNullOrEmpty(el.InnerText)) el.Remove();
            break;
        }
        else
        {
            previousRuns.Add(el.Descendants<Run>().ElementAt(i));
        }
    }
}

private static void MergeRunsWithKey(string key, List<Run> usedRuns, Run firstRun)
{
    while (!usedRuns.First().InnerText.Contains(key))
    {
        AddText(usedRuns.Skip(1).First().InnerText, firstRun);
        usedRuns.Skip(1).First().Remove();
        usedRuns.RemoveAt(1);
    }
}

private static void AddText(string newText, Run run)
{
    Text text = run.Elements<Text>().LastOrDefault();
    if (text == null)
    {
        run.Append(new Text());
        text = run.Elements<Text>().Last();
    }
    text.Text += newText;

    if (text.Text.StartsWith(" ") || text.Text.EndsWith(" "))
        text.Space = SpaceProcessingModeValues.Preserve;
}

已尝试的操作 #

• 将文件B中部分未知值（如页眉页脚矩形的gfxdata）替换为文件A的值，无效
• 尝试不同的AltChunkId生成方式并全局存储，无效
• 对比文档各部分内容，但差异过多无明显关联

排查建议 #

1. 校验OpenXML结构合法性：用OpenXML SDK的OpenXmlValidator工具扫描异常输出文件，直接定位结构错误（比如重复的ID、无效的元素嵌套、缺失的必需属性）。代码示例：

using (var doc = WordprocessingDocument.Open("异常文件路径", false))
{
    var validator = new OpenXmlValidator();
    var errors = validator.Validate(doc);
    foreach (var error in errors)
    {
        Console.WriteLine($"错误类型：{error.ErrorType}，位置：{error.Path.XPath}，消息：{error.Description}");
    }
}

2. 简化文件B进行测试：逐步移除文件B中的非核心内容（比如页眉页脚、样式、图片、形状），每次移除后测试插入AltChunk1是否正常，直到找到导致问题的模块。
3. 检查AltChunk插入后的上下文：文件B中插入位置的Paragraph/Run可能存在特殊属性（比如隐藏文本、特殊格式标记、自定义样式），对比文件A和B中对应位置的OpenXML元素细节，重点看ParagraphProperties、RunProperties中的差异。
4. 验证AltChunk源文件兼容性：将AltChunk1的内容直接复制到文件B中，看是否会触发同样的错误；或者用OpenXML SDK重新生成一个极简的AltChunk源文件（仅包含纯文本段落），测试在文件B中插入是否正常。
5. 跟踪文档部件的ID冲突：虽然你换了AltChunkId生成方式，但文件B可能本身存在重复的关系ID（不仅是AltChunk的ID），检查doc.MainDocumentPart.Parts中的所有部件ID是否唯一。
6. 查看Word的修复日志：Word修复文件后，会生成一个修复报告（通常在打开修复后的文件时可以查看，或者在文件属性的「详细信息」中找到），里面会记录具体的错误位置和原因。

内容的提问来源于stack exchange，提问作者T.Robin