[objectql] 字段 defaultValue 语义:显式 null 不回填、解析晚于 hook、表单不预填 current_user

[baozhoutao]

概述

想实现「新建记录时某人员字段默认当前用户」,用 Field.user({ defaultValue: 'current_user' }) 遇到三个叠加问题:

1. 解析顺序晚于 beforeInsert hook —— hook 读到 null,派生字段算错。
   定位:packages/objectql/src/engine.ts:2143(hook)先于 :2181(applyFieldDefaults)。(= chore(deps)(deps-dev): bump @vitest/coverage-v8 from 2.1.9 to 4.0.17 #29)
2. 只在「省略」时回填,显式 null 不回填 —— body 不含该字段 → 回填当前用户 ✅;body 显式 field: null → 不回填,落库 null ❌。
   定位:packages/objectql/src/engine.ts:802(判据 !== undefined)。
3. 创建表单不预填动态令牌 —— current_user / {current_user_id} 均不被解析成真实用户预填(停在「选择...」);静态默认(如 status:'planned')能预填。
   定位:objectui plugin-form/src/ObjectForm.tsx:702-712(原样拷贝 defaultValue,无令牌解析)。此子项归属 objectui,在本 issue 交叉引用,建议 objectui 侧同步跟进。

期望

• 服务端 defaultValue 对「显式 null」也回填(与「省略」一致),或文档化差异;
• 解析顺序前移到 beforeInsert hook 之前;
• (objectui)创建表单支持解析 current_user/{current_user_id} 预填用户字段。

规避

beforeInsert hook 读 ctx.session.userId 兜底回填。

---

来源(项目 dogfood):steedos-labs/os-tianshun-mtc#31 · 含 #29

[baozhoutao]

排查完成,处理如下:

#1 解析顺序晚于 beforeInsert hook — 已由 #2703(#2748)修复,applyFieldDefaults 现已在 beforeInsert 之前执行(engine.ts insert 路径),并有回归测试 resolves field defaults BEFORE beforeInsert ...。issue 里引用的旧行号已过时,无需再动。

#2 显式 null 不回填 — 已在 #2868 修复。applyFieldDefaults 判据由 !== undefined 改为 != null:insert 时"省略"与"显式 null"一视同仁,都视为"未提供值"并回填 default(含 current_user 令牌与静态默认)。

• 空串 '' 仍视为真实值,不覆盖。
• 仅影响 insert 路径 —— applyFieldDefaults 只在 insert() 调用,update() 从不调用它,所以 update 的"主动置 null"语义完全不受影响。这是选择"回填"而非"文档化差异"的关键依据:低代码表单把未选控件序列化成 null,与"省略"是同一意图,而 insert 语境下没有"既配了 default 又想强行落 null"的合理场景。
• 新增两条回归测试覆盖显式 null 回填 / 空串保留。

#3 创建表单不预填 current_user / {current_user_id} — 归属 objectui,本仓库不涉及(服务端只解析 current_user 字符串与 Expression 信封;{current_user_id} 是 objectui 表单自己的令牌约定)。保留本 issue 开启,待 objectui 侧同步跟进该子项。