JBPM Designer运行仿真按钮不可见问题求助（2.3.0.Final版）

开发者阿泽

2026-5-15

解决jBPM Designer 2.3.0中“Run Simulation”按钮不显示的问题

我之前也碰到过类似的问题，结合jBPM Designer 2.3.0的特性，给你几个排查和解决的方向：

检查仿真功能的依赖jar包
首先确认你的jbpm-designer-2.3.0.Final-tomcat.war解压后，WEB-INF/lib目录下是否包含jbpm-simulation-2.3.0.Final.jar（以及相关的依赖jar，比如kie-simulation-*.jar）。如果缺失这些文件，需要从jBPM完整发行包的lib目录中找到对应的jar，复制到Designer的WEB-INF/lib下，然后重启Tomcat。
验证Designer配置文件的仿真开关
找到WEB-INF/classes/designer.properties文件，检查是否存在以下配置项：
```
designer.simulation.enabled=true
```
如果没有，手动添加这一行；如果已经存在但值为false，修改为true。保存配置后重启Tomcat，这个开关是控制仿真UI元素是否加载的核心配置。
确认流程定义是否满足仿真要求
仿真功能并不是对所有流程都自动启用，你的流程需要包含支持仿真的元素（比如用户任务、服务任务，并且配置了基本的时间/成本参数）。尝试创建一个新的BPMN 2.0流程，添加几个用户任务后保存，再回到流程编辑页面查看按钮是否出现。
清除浏览器缓存并重启服务
浏览器缓存有时候会导致UI资源不更新，先清除当前浏览器的缓存（包括Cookie、本地存储），然后完全重启Tomcat服务器，重新登录Designer后再检查按钮状态。
查看Tomcat日志排查初始化错误
打开Tomcat的logs/catalina.out或者localhost.log日志文件，搜索关键词simulation，看看是否有类加载失败、初始化异常等错误信息。比如如果出现ClassNotFoundException关联到simulation相关类，说明依赖缺失，按照第一步的方法补充jar即可。