Files
dacli/src/core/dbLinkId.ts
T
sswandClaude 5a40afbb2e v0.11: 修复 BS-48 dbLinkId=default 别名解析
根因: dacli create 命令把 --dbLinkId=default 当字面量传给后端 URL
(/system/DataModel/default/Table), 后端查 dbLinkEntity=null 抛 NPE.
BS-48 guard 旧判定 !id || id==='0' || id==='', 不拦截 'default' 字符串.

web 行为参照: formDesign Form.vue 选 '默认' 自动用当前 app 业务库,
不应暴露 'default' 字面量到 URL.

修复:
- 新增 core/dbLinkId.ts: resolveDbLinkId() 统一别名解析
  (空/default/DEFAULT/主库/业务库 → token.dbLinkId)
- core/client.ts: JnpfClient.resolveDbLinkId() 委托给 core util
- 7 个 create 命令迁移到 c.resolveDbLinkId() 入口
  (dm create/drop/fields/list + form create/codegen/import)
- _blindspot_guards.ts BS-48: 增加 /^default$/i.test 拦截

实测:
- dacli dm create --dbLinkId=default → URL 走 2068901937849257984, 建表成功
- 单测 14/14 (dbLinkId) + 38/38 (blindspot_guards, 1 预存 BS-51 失败无关)
- TS 编译 src/ 0 差错

应用影响: docs/jxcj/design-jnpf.html 56 个 dm/form 命令全部用
--dbLinkId=default, 现在可直接 dispatch 不需改 design.

Co-Authored-By: Claude <[email protected]>
2026-06-22 21:51:25 +08:00

40 lines
1.4 KiB
TypeScript

/**
* core/dbLinkId.ts — dbLinkId 别名解析
*
* 规则:
* - undefined / '' / 'default' / 'DEFAULT' / '0' / '主库' / '业务库'
* → ctx.dbLinkId (从 token 读; ctx 缺失时回退 '0')
* - 其他 → 原值透传
*
* 兼容 web formDesign 自动解析行为:
* - web formDesign Form.vue 在 dbLinkId 字段如果用户选 "默认" / 留空,
* 会自动使用当前应用 systemId 对应的业务库 (来自 token).
* - dacli 必须等价地解析 'default' 别名, 否则 dispatch 的命令全部因
* 后端找不到 dbLinkEntity 而失败 (BS-48 假 PASS 案例).
*/
import type { AppContext } from './types.ts'
/**
* 解析 dbLinkId 别名.
*
* @param input 命令行传入的原始值 (来自 opts.dbLinkId)
* @param ctx AppContext (loadContextSafe() 返回; null/undefined 时容错)
* @returns 实际传给后端的 dbLinkId (string)
*/
export function resolveDbLinkId(
input: string | null | undefined,
ctx: AppContext | null | undefined,
): string {
// 别名集合: 空 / 'default' / '主库' / '业务库' / '0' 都映射到 ctx.dbLinkId
// '0' 也走别名 (兼容历史代码), 但 ctx 必须有有效 dbLinkId 才返回它,
// 否则保留 '0' (BS-1 业务表误用主库由 guard 拦截)
if (
!input
|| /^default$/i.test(input)
|| input === '主库'
|| input === '业务库'
) {
return ctx?.dbLinkId || '0'
}
return input
}