使用Open XML修改Word超链接为相对路径后未编辑链接变回绝对路径问题

问题背景 #

• 待交付客户的文档中存在大量指向\\server001\Files\...的绝对路径超链接，客户侧无权限访问该内网路径，因此编写C#代码遍历指定文件夹下的Word文档，将doc/docx后缀的超链接从绝对引用替换为本地相对引用。
  核心实现代码如下：

toc = WordprocessingDocument.Open(pathFile, true);
var baseUri = new Uri(pathFile, UriKind.Absolute);

IEnumerable<HyperlinkRelationship> all_hr = toc.MainDocumentPart.HyperlinkRelationships;
for (int index = 0; index < all_hr.Count(); index++)
{
    HyperlinkRelationship hr = all_hr.ElementAt(index);
    string link = hr.Uri.OriginalString.Replace("%20", " ");

    if (!(link.EndsWith(".doc") || link.EndsWith(".docx")))
        continue;

    if (hr.Uri.IsAbsoluteUri)
    {
        var newHr = new Uri(link, UriKind.Absolute);
        link = baseUri.MakeRelativeUri(newHr).OriginalString;
    }

    log.Info("Changed: " + hr.Uri.OriginalString + " to: " + link + " in file: " + sourceFile);
    var hyperlinkRelationshipId = hr.Id;
    toc.MainDocumentPart.DeleteReferenceRelationship(hr);

    try
    {
        toc.MainDocumentPart.AddHyperlinkRelationship(new Uri(link, UriKind.Relative), false, hyperlinkRelationshipId);
    }
    catch (Exception)
    {
        // 理论上链接仍为绝对路径时会进入该分支，实际运行未触发
    }
}

toc.Save();
toc.Close();

• 调试阶段验证：代码可正常识别目标绝对链接，修改后文档包内存储的链接确实为相对路径格式。但打开最终修复完成的文件时，所有代码完全未覆盖的其他引用被意外篡改，自动变回了file:///\\Server001\Files\...格式的绝对链接。
  运行日志输出示例：

16:49:43,738 [DOC2PDF] INFO - Changed: file:///\\Server001\Files\Main\RSL.doc to: ..\Main\RSL.doc in file: file:///\\Server001\Files\Main\INDEX.doc

问题根因 #

该问题由Word文档结构机制、OpenXML SDK行为、代码逻辑遗漏共同导致，本质是对Word引用机制的理解存在缺口：

1. 超链接覆盖范围不全
   OpenXML格式的Word文档是分部件存储的压缩包，代码中仅遍历修改了正文主部件MainDocumentPart下的超链接关系，但文档内的页眉、页脚、脚注、尾注、批注、文本框、嵌入内容、自定义XML部件中存储的超链接，都有独立的Relationships集合，这部分旧的绝对路径链接完全没被处理。
2. 残留超链接基础路径配置
   文档设置部件DocumentSettingsPart中存在HyperlinkBase配置项，存储了旧的内网服务器根路径\\server001\Files\。只要该配置未被清除，Word打开文档时会自动将所有相对路径超链接拼接该基础地址，重新解析为指向内网服务器的绝对路径，哪怕已经把链接存为相对格式也会被自动转换。
3. 直接在网络路径操作触发自动路径补全
   代码直接通过UNC网络路径打开源文件做修改，OpenXML SDK保存时、Word客户端打开文档做链接校验时，都会自动将文档内未明确标记为相对路径的外部引用，补全为当前文档所在位置的绝对UNC路径，未被处理的引用自然会被自动改回绝对路径格式。
4. 遍历逻辑存在bug
   代码直接遍历延迟执行的IEnumerable<HyperlinkRelationship>集合，循环过程中执行删除关系的操作会导致集合枚举错位，不仅会漏处理部分目标链接，还可能打乱其他引用关系的ID映射，导致非目标链接被错误修改。

修复方案 #

按以下步骤调整代码即可彻底解决问题：

• 不要直接在网络共享路径上操作源文件，先把待处理文件拷贝到本地磁盘路径再打开修改，确认修改结果正确后再同步到交付目录，避免触发SDK和Word的自动路径补全逻辑。
• 遍历文档所有包含外部引用的部件，不要仅处理主文档部件：需要覆盖HeaderPart、FooterPart、FootnotesPart、EndnotesPart、CommentsPart等所有部件的HyperlinkRelationships集合，逐个替换链接。
• 打开文档后首先检查MainDocumentPart.DocumentSettingsPart.Settings下的HyperlinkBase元素，如果存在直接删除，清除残留的旧基础路径配置。
• 提前将待遍历的超链接关系集合转为List<HyperlinkRelationship>再执行循环，避免延迟执行导致的枚举错位问题，不要在遍历原动态集合时直接增删元素。
• 用using代码块包裹WordprocessingDocument.Open的逻辑，退出代码块时SDK会自动完成正确的资源释放和全量保存，替代手动调用Save()和Close()的写法，避免残留临时路径标记。

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