使用docx4j库生成DOCX脚注异常，求正确实现方案

你的代码存在三个核心问题，导致脚注无法正常渲染：

问题分析 #

1. FootnotesPart关联方式错误
   直接将FootnotesPart放入wordMLPackage.getParts()，没有与MainDocumentPart建立合法的XML关系（.rels文件），Word无法定位到脚注内容的存储位置。

2. 脚注缺少编号引用元素
   自定义的CTFtnEdn没有包含脚注编号的引用标记，Word无法将正文的引用数字与脚注内容关联起来。

3. 缺少编号定义部件
   未添加NumberingDefinitionsPart，Word没有脚注编号的格式规则，无法正确生成和显示脚注编号。

修正后的完整代码 #

import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.openpackaging.parts.WordprocessingML.FootnotesPart;
import org.docx4j.openpackaging.parts.WordprocessingML.NumberingDefinitionsPart;
import org.docx4j.wml.*;

import java.io.File;
import java.math.BigInteger;

public class FootnoteCreator {

    public static void main(String[] args) throws Exception {
        createDocumentWithFootnote();
    }

    private static void createDocumentWithFootnote() throws Exception {
        // 创建文档包
        WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();
        MainDocumentPart mainDocPart = wordMLPackage.getMainDocumentPart();
        ObjectFactory factory = new ObjectFactory();

        // 1. 添加编号定义部件（必须，用于脚注编号）
        NumberingDefinitionsPart numberingPart = new NumberingDefinitionsPart();
        mainDocPart.addTargetPart(numberingPart);
        // 初始化默认的脚注编号格式（此处使用默认的阿拉伯数字编号）
        CTNumbering ctNumbering = factory.createCTNumbering();
        numberingPart.setJaxbElement(ctNumbering);

        // 2. 创建并关联FootnotesPart到主文档
        FootnotesPart footnotesPart = new FootnotesPart();
        mainDocPart.addTargetPart(footnotesPart);

        // 3. 构建正文段落及脚注引用
        P bodyParagraph = factory.createP();
        Text bodyText = factory.createText();
        bodyText.setValue("This is some text with a footnote.");
        R bodyRun = factory.createR();
        bodyRun.getContent().add(bodyText);

        // 创建脚注引用，设置ID对应脚注的ID
        R.FootnoteRef footnoteRef = factory.createRFootnoteRef();
        footnoteRef.setId(BigInteger.valueOf(1)); // 与脚注的ID一致
        bodyRun.getContent().add(footnoteRef);

        bodyParagraph.getContent().add(bodyRun);
        mainDocPart.getContent().add(bodyParagraph);

        // 4. 构建脚注内容
        CTFootnotes footnotes = factory.createCTFootnotes();
        CTFtnEdn footnote = createFootnote(factory);
        footnotes.getFootnote().add(footnote);
        footnotesPart.setJaxbElement(footnotes);

        // 保存文档
        wordMLPackage.save(new File("document_with_footnotes.docx"));
        System.out.println("文档创建成功！");
    }

    private static CTFtnEdn createFootnote(ObjectFactory factory) {
        CTFtnEdn footnote = factory.createCTFtnEdn();
        footnote.setId(BigInteger.valueOf(1)); // 与正文引用的ID一致
        footnote.setType(STFtnEdn.NORMAL); // 指定为普通脚注

        // 创建脚注段落：包含编号引用 + 脚注文本
        P footnotePara = factory.createP();

        // 添加脚注编号引用
        R footnoteRefRun = factory.createR();
        R.FootnoteRef footnoteRef = factory.createRFootnoteRef();
        footnoteRefRun.getContent().add(footnoteRef);
        footnotePara.getContent().add(footnoteRefRun);

        // 添加脚注文本
        Text footnoteText = factory.createText();
        footnoteText.setValue(" This is the footnote text.");
        R footnoteTextRun = factory.createR();
        footnoteTextRun.getContent().add(footnoteText);
        footnotePara.getContent().add(footnoteTextRun);

        footnote.getContent().add(footnotePara);
        return footnote;
    }
}

关键修改说明 #

• 使用mainDocPart.addTargetPart(footnotesPart)替代直接放入parts集合，自动生成正确的XML关系。
• 新增NumberingDefinitionsPart，为Word提供脚注编号的格式规则。
• 在脚注段落中添加FootnoteRef元素，建立正文引用与脚注内容的关联。
• 明确设置脚注的type为NORMAL，确保Word识别为普通脚注。

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