当前位置：首页 > news >正文

别再手动画流程图了！Flowable UI 6.6.0 + Tomcat 保姆级部署教程，从安装到登录一次搞定

news 2026/5/24 3:55:24

Flowable UI 6.6.0 全栈部署实战：从零搭建企业级流程设计平台

在数字化转型浪潮中，可视化流程引擎正成为企业提升运营效率的核心工具。作为Activiti原班团队打造的开源工作流引擎，Flowable以其轻量级架构和丰富的可视化组件备受开发者青睐。本文将带您完成Flowable UI 6.6.0与Tomcat的深度集成，通过全链路操作演示和高频问题预判，让您30分钟内搭建起完整的流程设计环境。

1. 环境准备与资源获取

部署前需要确认基础环境符合要求。推荐使用JDK 8/11与Tomcat 9.x组合，这是经过Flowable官方测试的稳定搭配。内存建议4GB以上，特别是需要同时运行多个War包时。

获取安装包的两种可靠途径：

官方GitHub发布页：在Flowable Releases页面下载flowable-6.6.0.zip完整包

Maven中央仓库：可通过以下命令直接获取WAR包：

mvn org.apache.maven.plugins:maven-dependency-plugin:get \ -Dartifact=org.flowable:flowable-ui:6.6.0:war

注意：生产环境务必验证文件哈希值，避免使用第三方修改版本。完整包应包含以下关键文件：
/wars ├── flowable-admin.war # 管理控制台 ├── flowable-idm.war # 身份认证中心 ├── flowable-modeler.war # 流程设计器 ├── flowable-task.war # 任务处理中心 └── flowable-rest.war # REST API接口

2. Tomcat深度配置指南

2.1 容器优化设置

在conf/server.xml中调整Connector配置，建议添加以下参数提升性能：

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" maxThreads="200" minSpareThreads="20" acceptCount="100" URIEncoding="UTF-8" compression="on" />

内存配置修改bin/setenv.sh（无则新建）：

export CATALINA_OPTS="-Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=512m"

2.2 多应用部署策略

将WAR包部署到Tomcat时有三种方案可选：

部署方式	优点	缺点	适用场景
直接拷贝到webapps	简单直接	无法控制启动顺序	开发测试环境
配置Context文件	可自定义路径和参数	需要手动创建配置文件	生产环境推荐
使用Manager应用	支持热部署	存在安全风险	临时调试

推荐方案：在conf/Catalina/localhost/下为每个应用创建独立的XML配置文件，例如flowable-ui.xml：

<Context docBase="/opt/flowable/wars/flowable-ui.war" reloadable="false"> <Parameter name="spring.datasource.jndi-name" value="jdbc/flowable" override="false"/> </Context>

3. 系统初始化与访问控制

3.1 首次启动的隐藏关卡

执行startup.sh后，需要特别关注几个关键节点：

启动顺序：IDM应用必须最先加载完成，否则其他模块会报认证错误

日志监控：通过tail -f logs/catalina.out观察关键事件：

INFO [main] org.apache.catalina.startup.HostConfig.deployWAR Deploying web application archive [/path/to/flowable-ui.war] INFO [main] org.flowable.ui.common.rest.idm.remote.RemoteIdmService Initializing Flowable IDM client with server root [http://localhost:8080/flowable-idm]

健康检查：访问http://localhost:8080/flowable-rest/actuator/health验证REST模块状态

3.2 安全加固方案

默认凭证admin/test必须立即修改，可通过以下任一方式：

IDM控制台：登录http://localhost:8080/flowable-idm修改

数据库直接操作（适用于批量修改）：

UPDATE ACT_ID_USER SET PASSWORD_ = '{bcrypt}$2a$10$N9qo8uLOickgx2ZMRZoMy.Mrq4H3dYjQ2AnmJYURqHRCmyXCXvD7u' WHERE ID_ = 'admin';

建议实施的五大安全措施：

启用HTTPS加密传输
配置IP访问白名单
定期轮换数据库密码
禁用不必要的REST API端点
开启操作日志审计功能

4. 模块联动与实战演示

4.1 流程设计到执行的闭环

在Modeler中创建采购审批流程时，关键配置项包括：

# 在bpmn文件中定义的服务任务 <serviceTask id="approvalTask" flowable:class="com.example.ApprovalServiceDelegate" flowable:async="true" flowable:exclusive="false"/>

各模块协同工作流程：

Modeler：设计包含用户任务的BPMN流程图
Task：发起人启动流程实例
IDM：验证任务处理人权限
Admin：监控运行中的流程实例

4.2 高可用部署架构

对于生产环境，推荐采用如下拓扑结构：

[负载均衡] | ------------------------------------- | | | [Tomcat节点1] [Tomcat节点2] [Tomcat节点3] | | | ------------------------------------- | [共享数据库集群]

配置共享存储需要修改flowable-ui-app.properties：

flowable.database.schema-update=false flowable.async.executor-activate=true flowable.idm.ldap.enabled=false

5. 故障排查工具箱

当遇到页面无法访问时，按以下步骤排查：

端口冲突检测：
```
netstat -tulnp | grep 8080
```
War包解压验证：
```
unzip -tq /path/to/flowable-ui.war
```

依赖检查工具：

// 在Spring Boot应用中添加检测端点 @RestController @RequestMapping("/api/diagnose") public class DiagnoseController { @GetMapping("/classpath") public String checkClasspath() { return ClassLoader.getSystemClassLoader().getResource("").getPath(); } }

常见问题速查表：

现象	可能原因	解决方案
登录后跳转空白页	Cookie域名配置错误	检查server.xml的Host名称
流程图无法保存	跨域请求被拦截	配置CorsFilter
任务分配不生效	用户组关联缺失	在IDM中检查group关联
中文乱码	数据库字符集非UTF8	修改my.ini配置

在完成所有部署后，建议使用Postman进行API连通性测试。这里分享一个我在金融项目中的实际配置：当需要对接内部审批系统时，需要在flowable-rest.properties中添加自定义拦截器：

flowable.rest.app.security.enabled=true flowable.rest.app.security.users[0].name=api_client flowable.rest.app.security.users[0].password={bcrypt}$2a$10$N9qo8uLOickgx2ZMRZoMy...

查看全文

http://www.jsqmd.com/news/854869/