SurrealDB中UPSERT MERGE操作导致字段丢失的问题分析

问题概述

在SurrealDB数据库2.0.x版本中，用户报告了一个关于UPSERT操作结合MERGE语法的严重问题。当使用UPSERT ... MERGE {}语法时，即使只是执行空合并操作，也会导致记录中原有字段被清除或设置为NONE，进而违反字段类型约束。

问题重现

通过以下测试用例可以稳定重现该问题：

REMOVE TABLE aaa;
DEFINE TABLE aaa SCHEMAFULL;
DEFINE FIELD cake ON aaa TYPE number;
DEFINE FIELD anything ON aaa FLEXIBLE TYPE any;

CREATE aaa:topLevel CONTENT {cake: 1};
UPSERT aaa:topLevel MERGE {};

在2.0.0-beta.2版本中，这个操作能正常工作，但在2.0.0及更高版本中会抛出错误："Found NONE for field cake, with record aaa:topLevel, but expected a number"。

技术分析

预期行为

按照数据库操作的常规语义，MERGE操作应该：

1. 只更新指定的字段
2. 保留未指定的字段不变
3. 对于空合并操作MERGE {}，应该不做任何修改

实际行为

在当前版本中，MERGE操作似乎将所有未指定的字段都设置为NONE，这违反了字段的类型约束（cake字段被定义为number类型，不能为NONE）。

版本对比

测试表明：

• 2.0.0-beta.2版本：工作正常
• 2.0.0及以上版本：出现此问题

这表明问题是在2.0.0正式版发布前引入的，可能是在重构或优化MERGE逻辑时产生的副作用。

影响范围

这个问题会影响所有使用以下特性的应用：

1. 使用SCHEMAFULL表结构
2. 依赖UPSERT MERGE操作进行部分更新
3. 使用字段类型约束

特别是在需要保持某些字段不变只更新部分字段的场景下，这个问题会导致数据损坏。

临时解决方案

在官方修复前，可以考虑以下替代方案：

1. 明确指定所有必填字段：

UPSERT aaa:topLevel MERGE {
    cake: $before.cake,
    // 其他必填字段
};

2. 使用UPDATE代替UPSERT：

UPDATE aaa:topLevel MERGE {};

3. 回退到2.0.0-beta.2版本（不推荐，因为会失去其他改进）

最佳实践建议

1. 在关键操作前进行备份
2. 对重要数据操作进行测试验证
3. 考虑使用事务确保数据一致性
4. 监控数据库日志以捕获类似问题

总结

这个BUG展示了数据库操作语义一致性的重要性。MERGE操作应该严格遵守"最小修改"原则，只影响明确指定的字段。SurrealDB团队需要检查2.0.0版本中MERGE操作的实现逻辑，找出为何会清除未指定字段的原因，并恢复beta版本中的正确行为。