JBPM 7.13中HTML表单元素使用及HTML组件嵌入PDF异常求助

我之前在JBPM 7.x版本折腾过类似的HTML组件渲染问题，给你梳理下核心原因和可行的解决办法：

先搞懂JBPM HTML组件的工作机制 #

JBPM表单里的HTML组件，默认会对输入的HTML内容做自动转义处理——这是出于XSS安全防护的考虑。简单说就是它不会把你输入的<iframe>这类标签当作网页元素解析，而是把所有标签转成纯文本直接显示，这就是你看到完整HTML代码的原因。

针对你的情况的具体解决步骤 #

1. 切换到HTML组件的源码编辑模式（关键操作） #

可视化编辑器会自动转义标签，所以你得用源码模式来输入HTML：

• 打开表单设计界面，选中你添加的HTML组件
• 在组件的配置面板里，找到「编辑源代码」或者「Source」选项（你可以在截图里找找类似的按钮，比如Part2里的源码切换入口）
• 进入源码模式后，粘贴正确的iframe代码（注意把你原来的方括号改成尖括号）：

<iframe src="http://****:****/****.pdf" style="width: 50%;height: 100%;border: solid;"></iframe>

2. 调整JBPM的内容安全策略（默认配置限制） #

JBPM默认的安全规则会限制iframe的加载来源，如果你的PDF地址是外部服务器，需要修改配置放行：

• 找到JBPM安装目录下的standalone/configuration/standalone.xml（域模式用domain.xml）
• 搜索Content-Security-Policy相关的配置项，在frame-src里添加你的PDF服务器域名：

<header name="Content-Security-Policy" value="frame-src 'self' http://****:****; ...保留原有其他配置..." />

修改后重启JBPM服务，这样页面才允许加载这个域名下的iframe内容。

3. 验证排查 #

• 先单独在浏览器里访问你的PDF URL，确认能正常打开，排除PDF服务器的问题
• 保存表单后启动流程实例，打开表单查看iframe是否渲染；如果还是失败，按F12打开浏览器控制台，看看有没有CSP限制或iframe加载报错，根据提示调整配置。

额外小提示 #

• JBPM 7.13默认用的是UberFire风格表单，HTML组件必须用源码模式输入HTML，可视化编辑模式会自动转义标签，这点一定要注意；
• 如果PDF是部署在JBPM同一服务器下的静态资源，可以把路径改成相对路径，减少跨域配置的麻烦。

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