dev 运行环境固化为 JDK 21 + 守卫启动脚本(防误用 JDK 26 致 Groovy 崩)
QA 全量巡检发现:dev 平台默认跑 homebrew openjdk(现为 26),致保真层服务流的 Groovy 4.0.27 在运行时解析 JDK 26 类(major 70)崩(GroovyBugError),35+ 命名查询流 500。 根因与 F2-13「报表 500」同族(那次修了编译目标 release=21,但运行时 JDK 仍可能是 26)。 - scripts/run-dev.sh:一键启动 platform/flowable,强制定位并校验 JDK 21(brew openjdk@21), 非 21 拒启;轮询等端口释放再起,防多实例/旧 JDK 残留。 - README:新增「运行环境必读:必须 JDK 21」,纠正过时的 openjdk@17 示例。 - 架构设计.md:运行时 JDK 17 → 21,补「不可用 JDK 26 / 升 JDK 须同步升 Groovy、目标 25」红线。 实测:platform(8093)+ flowable(8089)均切到 openjdk@21,登录/待办/服务流查询正常; 此前 JDK 26 下 500 的 PM_LABORCOMPANY_SEARCH_LISTINFO 等恢复返数据。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
23
README.md
23
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
|
||||
|
||||
|
||||
@@ -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 自然选择 |
|
||||
|
||||
87
scripts/run-dev.sh
Executable file
87
scripts/run-dev.sh
Executable file
@@ -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\"}'"
|
||||
Reference in New Issue
Block a user