P3-3: Flowable 5.13-SNAPSHOT→6.8.1 升级工具链产品化 + 演练全绿
一键链(tools/flowable-upgrade/): ①前置校验→②版本串规范化→③Flowable 5.23→④6.8.1 兼容层→⑤后置校验 全步骤幂等可重入;参数化 host/port/db/schema;JAVA_HOME 强制传 Maven。 完整重演(eip4flow_rehearsal,客户库只读口径): import_5x 63s | 一键链 21s | 后置全绿 1515 定义 / 9386 执行 / 9324 任务 / 26761 历史 全量就地保留 schema.version: 5.13-SNAPSHOT → 5.23.0.0 → 6.8.1.0 engineVer=v5 标记: 1515/1515 迁移手册新增坑6.4: Maven exec:java 在多 JDK 环境不走脚本 JAVA_HOME。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
12
docs/迁移手册.md
12
docs/迁移手册.md
@@ -484,14 +484,24 @@ com.dsasp.* com.eip4.*
|
||||
| **对策** | 将 3 个 handler 类从 `com.dsasp.server.wf` 移植到 `platform-flow-gateway` 模块;通过 `ProcessEngineConfiguration.setBeans(Map)` 注册(PoC 已验证注册机制有效);P3 阶段优先级最高 |
|
||||
| **影响范围** | **引用量**:`candidateUsersHandler` × 4,761 处(全量 1,509 个 BPMN)、`wfContextService` × 175 处、`multiInstanceUsersHandler` × 33 处;这 3 个 bean 未移植则流程发起/审批全部无法运行 |
|
||||
|
||||
### 6.4 Maven 调用 exec:java 时 JDK 不走脚本 JAVA_HOME(工具链坑)[NEW 2026-06-11]
|
||||
|
||||
| 栏目 | 内容 |
|
||||
|------|------|
|
||||
| **现象** | 升级脚本通过 `bash lib/03_upgrade_v5.sh` 调用时,`mvn exec:java` 报 `NoClassDefFoundError: org/yaml/snakeyaml/constructor/BaseConstructor`(snakeyaml 版本冲突),但在 terminal 直接运行 `mvn exec:java` 成功 |
|
||||
| **根因** | Homebrew Maven(3.9.x)在脚本子 shell 中用自身探测的 JDK(如 openjdk@26),而非脚本 `export PATH` 设置的 JDK;Java 26 + exec-maven-plugin 3.4.1 + snakeyaml 1.33(Flowable 6.8.1 传递依赖)存在 NoClassDefFoundError |
|
||||
| **对策** | 在调用 `mvn exec:java` 前显式 `export JAVA_HOME=<jdk17-path>` 并在 mvn 调用行传 `JAVA_HOME="${JAVA_HOME}"`;Maven 3.x 优先读 `JAVA_HOME` 环境变量覆盖自身探测结果;工具链 `03_upgrade_v5.sh` / `04_upgrade_v6.sh` 已修复 |
|
||||
| **影响范围** | 工具链在 macOS arm64 Homebrew 多 JDK 环境;生产 Linux 服务器通常只有一个 JDK,此坑概率低但须在生产前验证 `mvn -version` 显示的 Java 版本 = 目标 JDK |
|
||||
|
||||
**三坑汇总检查清单(写入升级 Runbook)**:
|
||||
|
||||
```
|
||||
□ 升级前:UPDATE act_ge_property SET value_='5.13' WHERE name_='schema.version'
|
||||
□ 第一步:Flowable 5.23 完整升级 + 验证 schema.version 达到 5.x 末版
|
||||
□ 第二步:Flowable 6.8.1 启用 flowable5-compatibility 升级
|
||||
□ 升级后:验证 1,509 个定义可见 + 抽取 3 个运行中实例续跑 + 候选人表达式解析正常
|
||||
□ 升级后:验证 1,515 个定义可见 + 抽取运行中实例 engineVer=v5 + schema.version=6.8.1.0
|
||||
□ platform-flow-gateway 已包含 3 个 handler bean + cfg.setBeans 注册
|
||||
□ 工具链运行前确认 JAVA_HOME 指向 JDK17(export JAVA_HOME=/path/to/jdk17)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user