C#生成Word文件报错：文件打开失败

我之前做类似的Word文档生成功能时，也踩过不少坑，结合你的代码片段，咱们来一步步排查和解决这个问题：

1. 优先排查文件权限与进程锁定问题 #

复制文件后马上打开，很容易碰到系统或者其他进程占用文件的情况，导致Open XML SDK无法获取读写权限：

• 先确认目标文件路径是否正确，当前程序有没有目标文件夹的读写权限（比如部署在IIS下的话，应用池身份需要对应权限）；
• 可以在复制后先尝试手动打开目标文件，看是否能正常打开——如果手动都打不开，大概率是文件被锁定了；
• 代码里可以加个小验证步骤，确保文件复制完成且可访问：

File.Copy(sourceFile, destinationFile, true);

// 验证文件可读写，避免进程锁定问题
bool isFileAccessible = false;
int retryCount = 3; // 重试3次
while (retryCount > 0 && !isFileAccessible)
{
    try
    {
        using (var fs = new FileStream(destinationFile, FileMode.Open, FileAccess.ReadWrite, FileShare.None))
        {
            isFileAccessible = true;
        }
    }
    catch (IOException)
    {
        retryCount--;
        Thread.Sleep(500); // 等待500ms再重试
    }
}

if (!isFileAccessible)
{
    throw new IOException("目标文件被占用，无法打开");
}

// 继续后续的Open XML操作

2. 检查文档流的写入逻辑是否完整 #

从你的代码片段看，读取文档文本后只做了部分替换操作，但没有把修改后的内容写回文档——这会导致文档内容损坏，直接触发“文件打开失败”：
完整的替换流程应该是这样的：

using (WordprocessingDocument wordDoc = WordprocessingDocument.Open(destinationFile, true))
{
    string docText = null;
    using (StreamReader sr = new StreamReader(wordDoc.MainDocumentPart.GetStream()))
    {
        docText = sr.ReadToEnd();
    }

    foreach (KeyValuePair<string, string> item in keyValues)
    {
        Regex regexText = new Regex(item.Key);
        docText = regexText.Replace(docText, item.Value); // 完成替换
    }

    // 关键：把修改后的文本写回文档流
    using (StreamWriter sw = new StreamWriter(wordDoc.MainDocumentPart.GetStream(FileMode.Create)))
    {
        sw.Write(docText);
    }
}

如果漏掉写入步骤，文档会处于不完整状态，Office自然无法打开。

3. 避免破坏Word的XML结构 #

直接用Regex替换整个文档文本很容易踩坑：

• 确保你的占位符（比如{NAME}）不会跨XML节点——Word会把文本拆分成多个<w:t>节点，正则替换可能破坏XML标签的完整性；
• 如果模板里用了内容控件、域代码，不要直接替换文本，应该用Open XML SDK的API操作对应的节点，比如：

  // 示例：替换内容控件的文本
  var contentControls = wordDoc.MainDocumentPart.Document.Body.Descendants<SdtElement>();
  foreach (var control in contentControls)
  {
      if (control.SdtProperties.GetFirstChild<Tag>()?.Val == "NamePlaceholder")
      {
          control.Descendants<Text>().First().Text = "替换后的内容";
      }
  }
  

• 另外，确认源模板是.docx格式，Open XML SDK不支持旧的.doc格式。

4. 增加异常日志定位具体问题 #

如果以上步骤都没问题，就把异常信息打出来，看具体是哪一步出错：

try
{
    // 你的完整代码
}
catch (Exception ex)
{
    // 这里可以写入日志或者输出详细错误
    Console.WriteLine($"错误类型：{ex.GetType().Name}\n错误信息：{ex.Message}\n堆栈跟踪：{ex.StackTrace}");
    throw; // 重新抛出异常，方便上层处理
}

比如如果是XmlException，那就是替换文本破坏了XML结构；如果是UnauthorizedAccessException，就是权限问题。

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