feat(diagnose): L3 diagnoseError 加 System abnormality 规则 (BS-触发器空串)

**触发条件**: 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 → 成功
This commit is contained in:
ssw committed 2026-06-23 12:01:04 +08:00
1 parent 2943bc439a
commit 6d7fb68f2c
2 files changed
+65 -1

No files matched your search

+39 -1
View File
@@ -508,9 +508,47 @@ export function buildFormCodegenCommand(): Command {
}
log.info(`POST /visualdev/Generater/${formId}/Actions/CodePreview`)
const r = await c.postJson<unknown>(`/visualdev/Generater/${formId}/Actions/CodePreview`, body)
// 走 callWithDiagnosis 让 client.diagnoseError() 触发, 输出 trigger='' 等修复指引
let r: Awaited<ReturnType<typeof c.postJson<unknown>>>
try {
r = await c.postJson<unknown>(`/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
+26
View File
@@ -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/<form_id> → 解析 formData.fields[].__config__')
causes.push(' b) trigger=="" → 按 jnpfKey 设值 (input/textarea/editor="blur", 其他="change")')
causes.push(' c) PUT /visualdev/Base/<form_id> (触发 state 1→2)')
causes.push(' d) POST /visualdev/Base/<form_id>/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 看后端日志')