From 6d7fb68f2cd2ec1d4774455783acf6262e9f6013 Mon Sep 17 00:00:00 2001 From: ssw Date: Tue, 23 Jun 2026 12:01:04 +0800 Subject: [PATCH] =?UTF-8?q?feat(diagnose):=20L3=20diagnoseError=20?= =?UTF-8?q?=E5=8A=A0=20System=20abnormality=20=E8=A7=84=E5=88=99=20(BS-?= =?UTF-8?q?=E8=A7=A6=E5=8F=91=E5=99=A8=E7=A9=BA=E4=B8=B2)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **触发条件**: CodePreview 返 'System abnormality' (后端 FormMarco.vm:1226 StringIndexOutOfBoundsException) **根因**: form formData.fields[].__config__.trigger = '' (空字符串) - PublicMacro/FormMarco.vm:1226 对 '' 调 substring(0,1) 抛错 - 仅 state=1 (发布态) 触发, state=2 (草稿) 不触发 (没走发布代码生成路径) - 历史 form (老 dacli/老 web 设计器) 易中招, 新 form FieldBuilder.ts:215-223 已正确设 **修复指引 (诊断输出)**: 1. 查后端日志: log/jnpf-java-boot/log_error.log | grep FormMarco 2. 一次性 PATCH (Python 脚本步骤 a/b/c/d) 3. web UI 打开 form 设计器保存一次, JNPF 自动补 trigger ⚠ state=1 vs state=2 触发差异提示 **调用方**: - codegen.ts CodePreview 失败分支调 diagnoseError 打印 - 客户端无法直接看后端堆栈, 规则放宽到 'System abnormality' (高频根因) **验证**: - TS compile clean - jxcj_team (state=1 + 8/8 trigger='') 跑 codegen → 完整诊断输出 (修复步骤) - jxcj_team (state=2 + 8/8 trigger='') 跑 codegen → 成功 (绕开 bug) - 修后 jxcj_team (state=1 + 0/8 trigger='') 跑 codegen → 成功 --- src/commands/form/codegen.ts | 40 +++++++++++++++++++++++++++++++++++- src/core/client.ts | 26 +++++++++++++++++++++++ 2 files changed, 65 insertions(+), 1 deletion(-) diff --git a/src/commands/form/codegen.ts b/src/commands/form/codegen.ts index ee416e5..d5da754 100644 --- a/src/commands/form/codegen.ts +++ b/src/commands/form/codegen.ts @@ -508,9 +508,47 @@ export function buildFormCodegenCommand(): Command { } log.info(`POST /visualdev/Generater/${formId}/Actions/CodePreview`) - const r = await c.postJson(`/visualdev/Generater/${formId}/Actions/CodePreview`, body) + // 走 callWithDiagnosis 让 client.diagnoseError() 触发, 输出 trigger='' 等修复指引 + let r: Awaited>> + try { + r = await c.postJson(`/visualdev/Generater/${formId}/Actions/CodePreview`, body) + } catch (e) { + const err = e as Error + log.error(`CodePreview 请求失败: ${err.message}`) + const causes = c.diagnoseError(err.message, { + appCode: c.appCode, + dbLinkId: c.dbLinkId ?? '', + tokenStatus: 'valid', + existingEnCodes: [], + unreleasedForms: [], + releasedForms: [], + modifiedAfterPublishForms: [], + existingTables: [], + menus: [], + currentVersion: '', + warnings: [], + }) + log.error(' 可能原因:') + for (const cause of causes) log.error(` ${cause}`) + process.exit(1) + } if (r.code !== 200) { log.error(`CodePreview 失败 (code=${r.code}): ${r.msg}`) + const causes = c.diagnoseError(`CodePreview ${r.msg}`, { + appCode: c.appCode, + dbLinkId: c.dbLinkId ?? '', + tokenStatus: 'valid', + existingEnCodes: [], + unreleasedForms: [], + releasedForms: [], + modifiedAfterPublishForms: [], + existingTables: [], + menus: [], + currentVersion: '', + warnings: [], + }) + log.error(' 可能原因:') + for (const cause of causes) log.error(` ${cause}`) process.exit(1) } const data = r.data as { list?: CodeTreeItem[] } | undefined diff --git a/src/core/client.ts b/src/core/client.ts index d44f7c0..377d7e2 100644 --- a/src/core/client.ts +++ b/src/core/client.ts @@ -380,6 +380,32 @@ export class JnpfClient { return causes } + // 规则 7: System abnormality — JNPF 后端 Velocity 模板 bug + // 根因 (高频): form 的 formData.fields[].__config__.trigger 为空字符串 '' + // PublicMacro/FormMarco.vm:1226 调用 ${trigger.substring(0,1)} 对 '' 抛 StringIndexOutOfBoundsException + // 只在 state=1 (发布态) 触发, state=2 (草稿) 不触发 (因为没走发布代码生成路径) + // 注: 后端堆栈只在 log_error.log 可见, dacli 客户端只看到 "System abnormality" 字面 + if (/System abnormality/i.test(errorMsg)) { + causes.push('JNPF 后端 "System abnormality" 错误, 最常见根因:') + causes.push(' form formData.fields[].__config__.trigger = "" (空串)') + causes.push(' PublicMacro/FormMarco.vm:1226 对空串调 substring(0,1) 抛 StringIndexOutOfBoundsException') + causes.push(' (仅 state=1 发布态触发, state=2 草稿不触发)') + causes.push(' 历史 form (老 dacli/老 web 设计器) 易中招, 新 form FieldBuilder.ts:215-223 已正确设') + causes.push('') + causes.push('诊断:') + causes.push(' 1. 查后端日志确认: log/jnpf-java-boot/log_error.log | grep FormMarco') + causes.push(' → 含 FormMarco.vm:1226 + StringIndexOutOfBoundsException 即本错误') + causes.push(' 2. 一次性 PATCH 修复 (Python):') + causes.push(' a) GET /visualdev/Base/ → 解析 formData.fields[].__config__') + causes.push(' b) trigger=="" → 按 jnpfKey 设值 (input/textarea/editor="blur", 其他="change")') + causes.push(' c) PUT /visualdev/Base/ (触发 state 1→2)') + causes.push(' d) POST /visualdev/Base//Actions/Release (state 2→1, 修复生效)') + causes.push(' 3. 或在 web UI 设计器打开 form 保存一次, JNPF 自动补 trigger') + causes.push('') + causes.push('⚠ 重要: 只在 state=1 (已发布) 出现, state=2 (草稿) 不报错') + return causes + } + // 兜底 causes.push(`未识别的错误: ${errorMsg.slice(0, 200)}`) causes.push(' 建议: 跑 dacli app context --json 确认环境, 或 dacli tool logs --level=error --lines=50 看后端日志')