使用docx4j更新.docx文件时只读字段变为可编辑的问题

数据老陈

2026-8-22

解决docx4j更新后只读字段变为可编辑的问题

问题分析

docx4j在更新文档内容时，可能会意外清除原文档中控制字段只读属性的XML配置节点，导致原本的只读引导区块失去保护，变为可编辑状态。

解决方案步骤

保留原文档保护配置：加载文档时，确保不覆盖或删除原有的w:documentProtection相关节点，这些节点是文档级只读保护的核心。

手动重置段落只读属性：更新完成后，遍历目标段落重新设置只读限制：

获取文档的MainDocumentPart核心内容节点
通过XPath或样式识别原只读区块的段落
为段落添加w:edit属性并设置为"readOnly"
示例代码：

MainDocumentPart mdp = wordprocessingMLPackage.getMainDocumentPart();
List<Object> paragraphs = mdp.getJAXBNodesViaXPath("//w:p", false);
for (Object obj : paragraphs) {
    if (obj instanceof P) {
        P p = (P) obj;
        // 此处需根据实际文档规则判断是否为只读区块，比如通过样式ID
        if ("ReadOnlyStyle".equals(p.getPPr().getStyle().getVal())) {
            PPr ppr = p.getPPr() == null ? new PPr() : p.getPPr();
            Edit edit = new Edit();
            edit.setVal("readOnly");
            ppr.setEdit(edit);
            p.setPPr(ppr);
        }
    }
}

确认文档保护生效：检查并启用文档级只读保护：

DocumentSettingsPart dsp = wordprocessingMLPackage.getDocumentSettingsPart();
CTProtectDocument protDoc = dsp.getContents().getProtectDocument();
if (protDoc == null) {
    protDoc = new CTProtectDocument();
    dsp.getContents().setProtectDocument(protDoc);
}
protDoc.setEnforcement(true);
protDoc.setVal(STDocProtect.READ_ONLY);