Docx4J生成Word文档后无法自动更新TOC问题求助

云原生阿岚

2026-6-29

Docx4j 更新/生成Word目录（TOC）无内容问题解决

问题分析

docx4j不会像Microsoft Word那样自动计算填充目录内容，模板中的TOC域默认不会触发更新，因此操作无报错但目录为空，而Word打开时会自动刷新域，所以手动操作能正常显示目录。

解决方案

1. 更新模板中的现有TOC域

使用docx4j的FieldUpdater工具强制更新TOC域，前提是文档内标题已正确应用Heading 1/2/3等标准样式：

import org.docx4j.Docx4J;
import org.docx4j.model.fields.FieldUpdater;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import java.io.File;

public void updateExistingToc(String inputDocPath, String outputDocPath) throws Exception {
    // 加载Word文档
    WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.load(new File(inputDocPath));
    
    // 初始化域更新器，更新所有域（包括TOC）
    FieldUpdater fieldUpdater = new FieldUpdater(wordMLPackage);
    fieldUpdater.update(true);
    
    // 保存更新后的文档
    Docx4J.save(wordMLPackage, new File(outputDocPath), Docx4J.FLAG_SAVE_ZIP_FILE);
}

2. 直接生成新的TOC

若模板中的TOC无法正常更新，可在指定位置直接生成基于标题样式的TOC：

import org.docx4j.toc.TocGenerator;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.wml.P;

public void generateNewToc(WordprocessingMLPackage wordMLPackage, P insertPosition) throws Exception {
    TocGenerator tocGenerator = new TocGenerator(wordMLPackage);
    // 参数说明：插入位置、TOC域代码、是否覆盖原有内容
    // 这里生成包含1-3级标题的TOC，显示页码并链接到标题
    tocGenerator.generateToc(insertPosition, "TOC \\o \"1-3\" \\h \\z \\u", false);
}