升级docx4j至11.4.11后转docx到pdf遇NoSuchMethodError求助

问题背景 #

升级docx4j从8.3.9到适配Java17的11.4.11版本后，docx转PDF时触发NoSuchMethodError，原因是RangeFinder类的双参数构造函数已被移除，仅保留无参构造。原构造函数逻辑为自动给传入的元素名添加org.docx4j.wml.前缀：

public RangeFinder(String startElement, String endElement) {
    this.startElement = "org.docx4j.wml." + startElement;
    this.endElement   = "org.docx4j.wml." + endElement;
}

替代方案（无需修改源码） #

直接使用无参构造+Setter方法替代，手动补全元素的完整类名（对应原构造自动添加的前缀）：
原来的调用代码：

RangeFinder rangeFinder = new RangeFinder("P", "SectPr");

修改为：

RangeFinder rangeFinder = new RangeFinder();
rangeFinder.setStartElement("org.docx4j.wml.P");
rangeFinder.setEndElement("org.docx4j.wml.SectPr");

为什么不推荐修改源码重编译？ #

修改源码重编译虽然能临时解决问题，但后续docx4j版本更新时，你需要重复修改编译，维护成本高，且容易出现版本不一致导致的其他兼容问题。官方移除该构造函数是API设计调整，遵循官方提供的Setter方式才是长期可行的方案。

额外检查 #

排查项目中所有使用RangeFinder双参构造的代码，统一替换为无参构造+Setter的写法，避免遗漏导致的其他报错。

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