MS Word XML文档损坏排查：表格单元格内嵌段落问题

可能的修复方向 #

1. 补充段落必要属性节点 #

MS Word对OOXML的格式要求比Google Docs更严格，即使段落不需要特殊样式，也建议添加空的<w:pPr>属性节点。修改后的XML示例：

<w:tc>
  <w:tcPr>
    <w:tcW w:w="3116" w:type="dxa"/>
  </w:tcPr>

  <w:p>
    <w:pPr></w:pPr>
    <w:r>
      <w:t>AAA</w:t>
    </w:r>
  </w:p> 

</w:tc>

2. 避免手动拼接XML，使用docx库API构建内容 #

不要直接插入原始XML节点，改用库提供的类来创建表格和段落，减少手动格式错误：

const { TableCell, Paragraph, WidthType } = require("docx");

// 用API创建带段落的表格单元格
const cell = new TableCell({
  width: {
    size: 3116,
    type: WidthType.DXA,
  },
  children: [new Paragraph("AAA")],
});

3. 校验XML语法完整性 #

用专业XML校验工具检查document.xml是否存在未闭合标签、编码异常或命名空间缺失问题。7zip查看无法发现隐性语法错误，而Word对这类错误的容忍度极低。

4. 对比Word修复后的文档差异 #

打开报错的文档时选择「修复」，保存修复后的文件，用7zip对比修复前后的document.xml，找到Word自动修正的节点，对应调整你的生成代码。

5. 升级docx库版本 #

检查你使用的docx库是否存在已知的Office 365兼容性bug，升级到最新版本通常能解决这类格式兼容问题。

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