diff --git a/README.md b/README.md index aa438c9..cf16d28 100644 --- a/README.md +++ b/README.md @@ -29,12 +29,33 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供 > eip4dev 刷新:`bash tools/local-devdb/build_devdb.sh --drop-target`(约 6 分钟) > 详见:`tools/local-devdb/本地开发库构建报告.md` +## ⚠️ 运行环境(必读):必须 JDK 21,不可用 JDK 26 + +**保真层老引擎的服务流脚本运行时走 JSR-223 调 Groovy 4.0.27(`pom.xml` 钉定)。** +**Groovy 4.0.27 不认 JDK 26 的字节码(class major version 70),会在编译脚本时抛 +`GroovyBugError: Unsupported class file major version 70`,导致大批服务流查询 +(`*_SEARCH_LISTINFO`/`*_SZWJ` 等)直接 500。** 项目 `maven.compiler.release=21`、 +生产环境=JDK 21(LTS),故本地开发也**必须用 JDK 21**。 + +⚠️ homebrew 默认的 `openjdk` 现在是 **26**——不显式指定 `JAVA_HOME` 会误用 26。 +请先 `brew install openjdk@21`,并始终用 JDK 21 启动。**推荐用守卫脚本(自动定位并强制 21):** + +```bash +# 一键启动(强制 JDK 21,自动关停旧实例;默认 platform+flowable 都起) +bash scripts/run-dev.sh both # 或 platform / flowable +EIP4_PROFILE=local bash scripts/run-dev.sh platform # 换 profile + +# 将来升 JDK:目标是下个 LTS=25(非 LTS 的 26 不用),且须同步升 Groovy + 跑对拍回归。 +``` + ## 常用命令 ```bash -export JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home +# 所有 mvn/java 命令都须用 JDK 21(见上「运行环境」) +export JAVA_HOME=/opt/homebrew/opt/openjdk@21 # 必须 21;openjdk@21/bin/java 应报 21.x mvn test # 全模块测试(含 ArchUnit) +# 启动:推荐 scripts/run-dev.sh(带 JDK 21 守卫);以下 mvn 方式同样要求 JAVA_HOME=21 # dev profile — 日常开发(真实数据副本 eip4dev,端口 8093) mvn spring-boot:run -pl platform-app -Dspring-boot.run.profiles=dev diff --git a/docs/架构设计.md b/docs/架构设计.md index 35e0413..f53eb9f 100644 --- a/docs/架构设计.md +++ b/docs/架构设计.md @@ -30,7 +30,7 @@ eip4-platform(Maven 多模块单体) | 决策 | 选择 | 理由 | |------|------|------| | 整体形态 | 模块化单体 + Flowable 独立服务(仅此一个独立) | 4 人团队 + 按客户私有化部署,拒绝微服务 | -| 运行时 | JDK 17 + Spring Boot 3.3.x | PoC 已验证,不追新 | +| 运行时 | **JDK 21**(LTS)+ Spring Boot 3.3.x | PoC 起于 JDK 17(Boot 3 最低要求、当时 LTS、不追新),F2-13 起编译目标升 `release=21`(修报表 500,见下)。**红线:不可用 JDK 26**——保真层服务流走 Groovy 4.0.27,其 ASM 不认 JDK 26 字节码(major 70),编译/运行均崩;升 JDK 须同步升 Groovy,目标取下个 LTS=25 而非 26 | | 数据访问 | JdbcTemplate,**不引入 ORM** | 引擎本就是 JdbcTemplate;动态建表与 JPA 范式相克 | | 平台表管理 | Flyway(只管 SYS_* 平台表) | 业务表由引擎动态建,不进 Flyway | | 认证 | Spring Security + 无状态 JWT | 免 session 共享,REST 自然选择 | diff --git a/scripts/run-dev.sh b/scripts/run-dev.sh new file mode 100755 index 0000000..96c5e2d --- /dev/null +++ b/scripts/run-dev.sh @@ -0,0 +1,87 @@ +#!/usr/bin/env bash +# ============================================================================ +# EIP4 本地开发启动脚本 —— 强制 JDK 21 运行(红线,见下)。 +# +# 【为什么必须 JDK 21,不能用 JDK 26】 +# 保真层老引擎(com.dsasp.*)的服务流脚本在运行时走 JSR-223 调 **Groovy 4.0.27** +# (pom.xml 钉定)。Groovy 4.0.27 的字节码解析器不认 JDK 26 的 class 格式 +# (major version 70),脚本引用 JDK 类时抛 GroovyBugError → 大批服务流查询 500 +# (`*_SEARCH_LISTINFO`/`*_SZWJ` 等)。换 JDK 21 后全部恢复。 +# 项目 maven.compiler.release=21、生产环境=21(LTS),故 dev 必须对齐 21。 +# homebrew 默认 `openjdk` 现为 26,不指定 JAVA_HOME 会误用 26 —— 本脚本即为防此。 +# 将来若要升 JDK(目标是下个 LTS=25,而非非 LTS 的 26),须同步升 Groovy 并跑对拍回归。 +# +# 用法: +# scripts/run-dev.sh [platform|flowable|both] # 默认 both +# EIP4_PROFILE=local scripts/run-dev.sh platform # 改 profile(默认 dev) +# 前置:先 `mvn -pl platform-app,flowable-service -am package -DskipTests` 出 jar。 +# ============================================================================ +set -uo pipefail +cd "$(dirname "$0")/.." # → eip4-platform 根 + +WHAT="${1:-both}" +PROFILE="${EIP4_PROFILE:-dev}" + +# ---- 1) 定位 JDK 21 ---- +JDK21="" +for c in \ + /opt/homebrew/opt/openjdk@21 \ + /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home \ + /usr/lib/jvm/java-21-openjdk ; do + if [ -x "$c/bin/java" ]; then JDK21="$c"; break; fi +done +if [ -z "$JDK21" ] && [ -x /usr/libexec/java_home ]; then + JDK21="$(/usr/libexec/java_home -v 21 2>/dev/null || true)" +fi +if [ -z "$JDK21" ] || [ ! -x "$JDK21/bin/java" ]; then + echo "✗ 找不到 JDK 21。请先安装: brew install openjdk@21" >&2 + echo " (保真层服务流用 Groovy 4.0.27,JDK 26 会因 'Unsupported class file major" >&2 + echo " version 70' 崩;项目目标=21、生产=21,故必须 21。)" >&2 + exit 1 +fi + +# ---- 2) 守卫:确认确实是 21(防 brew formula 漂移,如 openjdk@24 实测竟是 26)---- +MAJOR="$("$JDK21/bin/java" -version 2>&1 | sed -nE 's/.*version "([0-9]+).*/\1/p' | head -1)" +if [ "$MAJOR" != "21" ]; then + echo "✗ $JDK21 实际是 JDK ${MAJOR:-未知},不是 21。拒绝启动(Groovy 兼容性红线)。" >&2 + echo " 请确认 brew install openjdk@21 装的是真 21。" >&2 + exit 1 +fi +export JAVA_HOME="$JDK21" +export PATH="$JAVA_HOME/bin:$PATH" +echo "✓ JDK 21 就位: $JAVA_HOME (profile=$PROFILE)" + +# ---- 3) 启动 ---- +run_jar() { # 名称 jar通配 端口 日志 + local name="$1" glob="$2" port="$3" log="$4" jar + jar="$(ls $glob 2>/dev/null | head -1)" + if [ -z "$jar" ]; then + echo "✗ $name 未构建($glob)。先跑: JAVA_HOME=$JAVA_HOME mvn -pl $name -am package -DskipTests" >&2 + return 1 + fi + # 清掉占端口的旧实例(防多实例/旧 JDK 残留),并轮询等端口真正释放(kill 后释放有延迟) + for p in $(lsof -nP -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null); do + echo " 关停端口 $port 旧实例 pid $p"; kill "$p" 2>/dev/null || true + done + for _ in $(seq 1 15); do + [ -z "$(lsof -nP -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null)" ] && break + sleep 1 + done + if [ -n "$(lsof -nP -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null)" ]; then + echo " 端口 $port 仍被占用,强制 kill -9"; lsof -nP -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null | xargs -r kill -9 2>/dev/null || true + sleep 2 + fi + echo "▶ 启动 $name (:$port): $jar" + nohup "$JAVA_HOME/bin/java" -jar "$jar" --spring.profiles.active="$PROFILE" > "$log" 2>&1 & + echo " pid $! 日志: $log" +} + +case "$WHAT" in + platform) run_jar platform-app "platform-app/target/platform-app-*.jar" 8093 /tmp/eip4-platform.log ;; + flowable) run_jar flowable-service "flowable-service/target/flowable-service-*.jar" 8089 /tmp/eip4-flowable.log ;; + both) + run_jar flowable-service "flowable-service/target/flowable-service-*.jar" 8089 /tmp/eip4-flowable.log || true + run_jar platform-app "platform-app/target/platform-app-*.jar" 8093 /tmp/eip4-platform.log || true ;; + *) echo "用法: $0 [platform|flowable|both] (默认 both)"; exit 2 ;; +esac +echo "完成。健康检查:curl -s localhost:8093/api/auth/login -XPOST -H 'Content-Type: application/json' -d '{\"account\":\"admin\",\"password\":\"111111\"}'"