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:
2026-06-13 20:09:49 +08:00
parent e6054a376b
commit d3986031d2
3 changed files with 110 additions and 2 deletions

87
scripts/run-dev.sh Executable file
View 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\"}'"