TinyBase SQLite持久化中的OR REPLACE问题解析

在TinyBase项目中使用SQLite作为数据持久化层时，开发者发现了一个值得注意的行为差异问题。当通过store.setCell()方法修改已有单元格值时，如果启用了orReplace=1选项，会导致该行其他列的值被意外置为NULL。

问题现象

正常情况下，调用setCell()方法修改单元格值时，预期行为是仅修改目标单元格，保持行中其他列的值不变。但在使用自定义SQLite持久化器（如PowerSync）并启用orReplace选项时，生成的SQL语句会带来副作用。

典型的问题SQL语句形如：

INSERT OR REPLACE "table_name" ("_id","col_to_change") VALUES (?,?);

这种语句会导致除主键和被修改列外，该行所有其他列都被设置为NULL，这显然不符合大多数应用场景的预期。

技术背景

SQLite的INSERT OR REPLACE语法是一种特殊的插入操作，当遇到主键或唯一索引冲突时，它会先删除原有行，再插入新行。这与标准SQL中的ON CONFLICT DO UPDATE语法有本质区别：

1. OR REPLACE是删除后重新插入，未指定的列会丢失
2. ON CONFLICT DO UPDATE是真正的更新操作，只修改指定列

TinyBase原本针对PowerSync等不支持ON CONFLICT语法的SQLite实现提供了orReplace选项，但在实现时未考虑到这种语义差异。

解决方案

经过社区讨论和代码审查，TinyBase团队在v5.3.3版本中修复了这个问题。主要改进包括：

1. 重构了测试用例，使用更接近真实环境的wa-sqlite模拟器
2. 修改了SQL生成逻辑，确保在orReplace模式下也能保留未修改列的值
3. 优化了PowerSync等特殊实现的兼容性处理

修复后的实现会生成包含所有列值的完整INSERT语句，确保行数据的完整性。

开发者建议

对于需要使用SQLite持久化的TinyBase开发者，建议：

1. 升级到v5.3.3或更高版本以获得修复
2. 如果必须使用旧版本，可通过setRow替代setCell作为临时解决方案
3. 在自定义持久化器实现时，特别注意SQL语法的语义差异

这个问题也提醒我们，在使用ORM或抽象层时，仍需了解底层数据库的特定行为，特别是在处理数据更新等关键操作时。