使用Apache POI更新docx表单域遇XWPFFormField缺失，求替代方案

你提到的XWPFFormField类并非Apache POI标准库中的类，要操作Word表单域，需借助XWPF的底层OOXML API（基于OpenXML规范的CT*系列类）来实现。

依赖准备 #

确保引入正确的Apache POI依赖（以Maven为例）：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version> <!-- 推荐使用最新稳定版 -->
</dependency>

代码实现 #

以下是针对不同类型表单域的更新示例：

1. 更新文本表单域 #

遍历文档段落，匹配并更新文本类型的表单域：

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFormField;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTextInput;

import java.io.FileInputStream;
import java.io.FileOutputStream;

public class FormFieldUpdater {
    public static void main(String[] args) throws Exception {
        try (XWPFDocument doc = new XWPFDocument(new FileInputStream("input.docx"))) {
            // 遍历所有段落查找表单域
            for (XWPFParagraph para : doc.getParagraphs()) {
                // 处理简单域类型的表单
                if (para.getCTP().getFldSimpleList() != null) {
                    para.getCTP().getFldSimpleList().forEach(fldSimple -> {
                        String instr = fldSimple.getInstr().trim();
                        if (instr.startsWith("TEXTFORMTEXT")) {
                            String fieldTitle = instr.split(" ")[1];
                            if ("姓名".equals(fieldTitle)) {
                                para.setText("张三");
                            }
                        }
                    });
                }

                // 处理标准表单域类型
                if (para.getCTP().getFormFieldList() != null) {
                    for (CTFormField formField : para.getCTP().getFormFieldList()) {
                        if (formField.getTxtInput() != null) {
                            String fieldName = formField.getName();
                            if ("userName".equals(fieldName)) {
                                formField.getTxtInput().setDefault("张三");
                                para.setText("张三");
                            }
                        }
                    }
                }
            }

            // 保存修改后的文档
            try (FileOutputStream out = new FileOutputStream("output.docx")) {
                doc.write(out);
            }
        }
    }
}

2. 更新复选框表单域 #

在上述遍历段落的循环中添加以下代码，处理复选框类型：

if (formField.getCheckBox() != null) {
    String fieldName = formField.getName();
    if ("agreeTerms".equals(fieldName)) {
        // 1代表选中，0代表未选中
        formField.getCheckBox().setDefault(1);
        para.setText("☑");
    }
}

3. 更新下拉表单域 #

同样在遍历循环中添加以下代码，处理下拉选择类型：

if (formField.getDropDownList() != null) {
    String fieldName = formField.getName();
    if ("gender".equals(fieldName)) {
        // 设置选中选项的索引（从0开始）
        formField.getDropDownList().setDefault(1);
        para.setText("男");
    }
}

注意事项 #

• 需在Word创建表单时为每个表单域设置名称属性，以便代码精准匹配。
• 表单域分为简单域（fldSimple）和标准表单域（formField）两种实现，代码中需兼顾两种情况。
• 更新底层CT对象后，务必同步更新段落的显示文本，否则打开文档可能无法看到修改效果。

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