WatermelonDB中日期字段更新问题的解决方案

在WatermelonDB数据库使用过程中，开发者可能会遇到日期类型字段更新异常的问题。本文将以一个典型的笔记应用场景为例，深入分析问题原因并提供完整的解决方案。

问题现象

开发者在实现笔记软删除功能时，发现使用@date装饰器标记的deletedAt字段无法正常更新。具体表现为：

1. 当尝试将deletedAt设置为Date.now()时更新失败
2. 将字段类型改为@field并使用字符串类型后却能正常工作

根本原因分析

经过排查，发现问题的核心在于WatermelonDB对日期类型字段的特殊处理机制：

1. 类型不匹配：@date装饰器要求底层数据库字段类型必须为"number"，而开发者最初在schema中将其定义为"string"
2. 值类型错误：直接传递Unix时间戳（Date.now()返回值）给@date字段，而WatermelonDB期望接收的是Date对象实例

完整解决方案

1. Schema定义修正

export const Table = {
  note: {
    name: "note",
    columns: [
      {
        name: "deleted_at",
        type: "number",  // 必须为number类型
        isOptional: true,
        isIndexed: true
      }
    ] satisfies ColumnSchema[]
  }
} as const;

2. 模型层正确用法

export default class Note extends Model {
  static table = Table.note.name;

  @date("deleted_at") deletedAt!: Date | null;

  // 正确更新方式
  static async softDelete(id: string) {
    await database.write(async () => {
      const note = await notes.find(id);
      await note.update((note) => {
        note.deletedAt = new Date(); // 必须使用Date对象
      });
    });
  }
}

高级应用：控制updatedAt更新

针对开发者提出的"防止特定操作更新updatedAt"的需求，WatermelonDB本身不提供内置机制，但可以通过以下方式实现：

1. 临时保存时间戳：

const originalUpdatedAt = note.updatedAt;
await note.update((note) => {
  note.deletedAt = new Date();
  note.updatedAt = originalUpdatedAt; // 恢复原值
});

2. 自定义中间件： 通过扩展WatermelonDB的适配器层，在特定操作时跳过updatedAt的自动更新。

最佳实践建议

1. 始终确保@date字段对应的schema类型为"number"
2. 更新操作时传递Date对象而非时间戳
3. 对于需要精确控制时间戳的场景，考虑在业务层实现逻辑
4. 重要时间字段（如createdAt）建议标记为@readonly防止意外修改

通过以上解决方案，开发者可以正确处理WatermelonDB中的日期类型字段更新问题，并实现更复杂的业务场景需求。