Files
eip4-web/docs/P1/F2-13缺陷批次报告.md
zhengwr b77952439c F2-13: 缺陷批次报告
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 23:34:33 +08:00

4.9 KiB
Raw Blame History

F2-13 缺陷批次报告

日期:2026-06-11
执行:Claude Fable 5 (Executor)


五项修复验收证据

1. 编译目标降 release=21(修报表 500)

根因:JDK26 编译产生 major version 70 字节码,Groovy 4.0.24 内嵌 ASM 不支持,报表取数链路崩溃。

修法:

  • pom.xml:source/target=17 → maven.compiler.release=21,java.version=17 → 21
  • groovy-jsr223 版本 4.0.24 → 4.0.27(本地 jar 已存在)
  • platform-legacy-core/pom.xml:删除 gmavenplus plugin
  • SecureGroovyScriptEngineFactory.groovy + MethodCallExpressionChecker.groovy → 转写为 Java,彻底消除 JDK26 下 ASM generateStubs 崩溃

验收:

  • 全量编译 mvn -o clean package -Dmaven.test.skip=true → BUILD SUCCESS
  • 编译产物 major version:65(Java 21)
  • /api/page/schema/03ec5566-7d99-4eba-85ce-31e25f5e48ab:title="月度检查整改",页面正常渲染(非 500)
  • /api/script/execute-template 返回 200(不回归)
  • 截图:e2e/artifacts/f2-13/type200-03ec5566-data.png

2. 转换器 title 取源修复

根因:1,291/1,493 产物 title="测试"。convertCrud/convertReport 等取 XML title 属性,而非 view_template.name。

修法:

  • TemplateToAmisConverter.convertGraded 增加 templateName 参数
  • BatchConvertCli 传入 view_template.name
  • 所有 convert* 方法优先用 templateName 作为 page title

验收:

SELECT schema_json->>'title', name FROM eip3.sys_page_schema LIMIT 5;
-- 会议纪要归档表单 | 会议纪要归档表单
-- E2E写路径测试-角色新增 | E2E写路径测试
-- 物资供应商临时合格设置 | 物资供应商临时合格设置

title=name 对齐;剩余 2 条 title="测试" 是模板本名即为"测试"的正常情况。


3. 转换器生成 form 提交 api

状态:TemplateToAmisConverter.convertForm 第302行已有 api: /api/entity/{table}/save,此项在 F2-2 阶段已实现。F2-3 重入库冲掉手改记录后,重批(第4项)已恢复。


4. 重批+重入库

重批结果:

总量: 1516
闸一(schema)通过: 1489 (98.2%)
onEvent 脚本钩子挂载: 380 个模板
分级: PARTIAL=1230  SUCCESS=259  FAILED=27
  • onEvent 挂载 380 模板(与之前量级一致)
  • 闸一 98.2%(保持)
  • 幂等双库入库:eip4dev 更新 1472 / eip4m0 更新 1472

mock seq 核对:

  • welfare-settlement.json:templateId=0d9eac07...,seq=2,与 full_auto_index 吻合
  • office-collar.json:onEvent actions 0(该模板无 FULL_AUTO 脚本,正常)

5. 前端 Tab 深链接 + flowable biz 数据源

Tab 深链接:

  • AppShell.tsx:直开 /page/:id 时自动加入 tabs 并激活
  • TabTitleContext.ts:新增 Context 提供 updateTabTitle 回调
  • PageRenderPage.tsx:schema 加载成功后回填 Tab title
  • 截图:e2e/artifacts/f2-13/type200-03ec5566-data.png(Tab 标题="月度检查整改")

flowable biz 数据源:

  • flowable-service/application.yml:biz.datasource 默认 URL 从 192.168.20.68:5435 改为 localhost:5433/eip4dev,用户 zhengwr

终验

e2e 全套

34 passed (20.7s)

34/34 全绿(含 crud-write #1 由之前 1 红转绿)

走查截图

  • e2e/artifacts/f2-13/type1-00551ef5-title.png:深链接 Tab 自动创建(404 模板正常降级显示错误卡片)
  • e2e/artifacts/f2-13/type200-03ec5566-data.png:type200 报表页正常渲染,Tab 标题="月度检查整改",非 500

两服务状态

  • 8093 platform-app:RUNNING(dev profile,release=21 字节码)
  • 8089 flowable-service:RUNNING(biz 数据源已切 5433/eip4dev)

提交哈希清单

(platform 仓库)

  • 6e9a39a F2-13: 修编译目标降 release=21 + 升 Groovy 4.0.27 + .groovy 转 Java(修报表 500)
  • 6e5880f F2-13: 转换器 title 取 view_template.name(修 title=测试 问题)
  • b412022 F2-13: flowable-service biz 数据源改 5433/eip4dev(修人名解析降级)

(web 仓库)

  • 5536e39 F2-13: Tab 深链接 + schema title 回填(直开 /page/:id 自动建 Tab)

新坑记录(迁移手册追加)

  1. groovy-jsr223 + JDK26 兼容性:Groovy 4.0.x 内嵌 ASM 的 AsmDecompiler 在 JDK23+ 下会通过 classloader 读取 JDK 内部类字节码触发版本崩溃。根治方案:将 .groovy 源文件转写为 .java,彻底移除 gmavenplus,避免此类构建时依赖。groovy-jsr223 运行时不受影响(只在 script 执行时工作,不进行静态分析)。

  2. maven.compiler.release vs source/target:JDK26 下只有 maven.compiler.release=N 才能真正约束输出字节码级别;source/target=N 不足以阻止 JDK26 编译器在某些路径下产生更高版本字节码。

  3. 转换器产物幂等性:load_page_schema.py 是幂等的(insert 0/update N),但每次重批后务必核对 mock 文件的 templateId+seq 与 full_auto_index 是否一致,防止 seq 漂移。