flowable6.8.0 升级到7.1.0

<think>嗯，用户想将Flowable从6.8.0升级到7.1.0，需要迁移指南和版本变化的信息。首先，我得回忆一下Flowable的版本更新情况。Flowable 7.x相对于6.x有哪些重大变化呢？记得官方文档中提到过包名从org.flowable改成了com.flowable，这可能影响现有的代码，需要替换所有相关的导入语句。另外，流程定义的方式可能有变化，比如BPMN模型的结构或者某些属性的使用方式。 然后是数据库迁移的问题。Flowable升级通常需要执行数据库脚本，用户需要备份现有数据库，然后运行7.1.0提供的升级脚本。可能需要检查数据库的版本兼容性，比如是否支持MySQL 8.x或者其他数据库版本的变化。 还有Spring Boot集成的部分，用户之前用的是6.8.0，现在要升级到7.1.0，可能需要调整依赖项的版本号，确保Maven或Gradle中的依赖正确指向新版本。另外，配置类可能有变化，比如某些配置属性被废弃或重命名，需要检查application.properties或.yml文件中的配置项。 用户提到引用了三个资源，其中两个是关于Flowable 6.8.0的资源文件和部署，另一个是Spring Boot集成。升级到7.1.0后，可能需要重新下载新的资源文件，比如FlowableUI的设计器是否有更新，WAR包是否兼容Tomcat的新版本。此外，自动部署的BPMN文件可能需要根据新版本的规范进行调整，比如XML命名空间或schema的变化。 另外，用户可能需要了解API的变化，比如某些Service类的方法签名是否有变动，或者是否有新的API推荐使用。例如，RuntimeService或TaskService中的方法是否有废弃的情况，需要替换成新的方法。还有，流程实例的迁移工具是否存在，如果需要将运行中的流程实例从6.8.0迁移到7.1.0，是否有官方工具支持。 测试也是关键的一环，升级后需要全面测试现有流程，确保流程定义正确部署，任务处理、网关条件、服务任务等都能正常工作。可能需要查看日志，处理可能的兼容性问题或异常。 可能用户没有考虑到的是，社区支持和文档的参考。Flowable的官方迁移指南应该是首要参考资料，需要引导用户查阅官方文档，同时注意社区论坛或GitHub上的已知问题和解决方案。此外，依赖的第三方库是否有冲突，比如Spring Boot的版本是否与Flowable 7.1.0兼容，可能需要升级Spring Boot到特定版本。 最后，提醒用户在升级前做好完整的备份，包括代码和数据库，以便在出现问题时可以回滚。分步骤进行升级，先升级开发环境，测试无误后再部署到生产环境。</think>### Flowable 从 6.8.0 升级到 7.1.0 的迁移指南 #### 一、版本变化与兼容性 1. **包名变更** Flowable 7.x 开始，包路径从 `org.flowable` 改为 `com.flowable`[^1]。需全局替换代码中的旧包名。 示例： ```java // 旧版本 import org.flowable.engine.RuntimeService; // 新版本 import com.flowable.engine.RuntimeService; ``` 2. **依赖管理调整** Maven/Gradle 依赖需更新为 7.1.0 版本： ```xml <dependency> <groupId>com.flowable</groupId> <artifactId>flowable-engine</artifactId> <version>7.1.0</version> </dependency> ``` 3. **数据库升级** - 执行官方提供的数据库迁移脚本（位于 `flowable-7.1.0/database/upgrade`）[^2]。 - 备份原数据库后，通过 `flowable-database-updater` 工具自动升级。 - 检查表结构变化（如 `ACT_RU_TASK` 新增字段）。 #### 二、关键配置变更 1. **Spring Boot 集成** - 配置文件需适配新版本属性： ```yaml flowable: database-schema-update: true # 自动更新数据库 async-executor-activate: true ``` - 若使用自动部署的 BPMN 文件（如 `leave-request.bpmn20.xml`），需验证其兼容性[^3]。 2. **Flowable UI 调整** - 7.1.0 的 Flowable UI WAR 包需重新部署到 Tomcat，注意 Tomcat 版本需 ≥ 9.x。 - 前端资源路径可能变化（如静态文件目录结构调整）。 #### 三、API 与行为变更 1. **流程定义接口** - `RepositoryService` 的 `createDeployment` 方法新增参数校验逻辑。 - 流程实例启动时，若变量类型不匹配会抛出 `FlowableIllegalArgumentException`。 2. **历史数据迁移** - 使用 `flowable-upgrade-helper` 工具迁移历史流程实例数据。 - 注意 7.x 对历史表（如 `ACT_HI_TASKINST`）的字段扩展。 #### 四、操作步骤 1. **备份与测试环境** - 备份数据库和代码仓库。 - 在开发环境验证升级流程，确保流程引擎、任务处理正常。 2. **分阶段升级** - 先升级依赖库，修复编译错误。 - 执行数据库迁移脚本，检查表结构和数据完整性。 - 验证核心业务流程（如请假流程 `leave-request.bpmn20.xml`）的部署与执行[^3]。 #### 五、常见问题 1. **启动报错：类找不到** - 检查包名是否全部替换为 `com.flowable`。 - 清理 Maven/Gradle 缓存，重新拉取依赖。 2. **流程无法部署** - 确认 BPMN 文件是否符合 7.1.0 的 XML Schema（命名空间更新为 `http://flowable.org/bpmn`）。 --- ###