Tomcat迁Wildfly后Header.setMarkupAttribute报错的Java替代方案咨询

核心原因 #

你遇到的报错是iText版本兼容问题：Tomcat环境使用的是旧版iText（如5.x系列），其中Header类提供了setMarkupAttribute方法；但Wildfly环境可能引入了更高版本的iText（如7.x），该方法已被移除，API结构也发生了调整。

替代代码实现 #

根据iText 7.x的API规范，提供两种可行的替代方案：

方案1：通过HTML片段转换（简单直观） #

直接构造包含script标签的HTML字符串，再转换为iText可识别的元素添加到文档：

import com.itextpdf.html2pdf.HtmlConverter;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.layout.element.IBlockElement;
import com.itextpdf.layout.element.IElement;
import java.util.List;

// 构造script标签的HTML内容
String scriptHtml = "<script src=\"../../hisglobal/js/jquery-main.min.js\"></script>";
// 将HTML转换为iText元素列表
List<IElement> elements = HtmlConverter.convertToElements(scriptHtml);
// 遍历添加到PDF文档
for (IElement element : elements) {
    document.add((IBlockElement) element);
}

方案2：使用iText7原生API构建脚本节点（适合自定义场景） #

通过iText7的节点API直接创建脚本元素：

import com.itextpdf.html2pdf.HtmlConverter;
import com.itextpdf.html2pdf.html.node.impl.js.ScriptNode;
import com.itextpdf.layout.element.IBlockElement;
import com.itextpdf.layout.element.IElement;

// 创建Script节点并设置src属性
ScriptNode scriptNode = new ScriptNode();
scriptNode.setAttribute("src", "../../hisglobal/js/jquery-main.min.js");
// 转换为iText元素并添加到文档
IElement element = HtmlConverter.convertToElement(scriptNode);
document.add((IBlockElement) element);

额外注意事项 #

• 确保项目依赖的iText7版本与Wildfly环境中的版本一致，避免依赖冲突。如果Wildfly自带了iText，可通过Maven/Gradle将依赖的scope设为provided，或在Wildfly的配置中排除自带的iText模块。
• 导入语句需对应iText7的包路径，避免混用旧版iText的导入。

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