Legend-State与Supabase同步机制深度解析

核心问题现象

在使用Legend-State的Supabase同步插件时，开发者发现当向store中设置带有新ID的数据时，系统会立即触发PATCH请求而非预期的POST请求。经过排查发现，这与数据对象中的时间戳字段设置密切相关。

同步机制原理解析

1. 同步行为触发条件

• 当数据对象包含created_at字段时，插件会认为这是已存在记录，触发PATCH更新
• 当缺少created_at字段时，才会触发POST创建请求

2. 时间戳字段的核心作用

• created_at和updated_at字段用于区分记录来源：
  • 服务端生成的记录：包含完整时间戳
  • 本地创建记录：应不包含时间戳

3. 最佳实践方案

// 正确的新建记录方式（不包含时间戳）
boardsStore$[id].set({
  id: generateId(),
  name: 'New Board',
  is_public: false,
  description: 'New Board Description'
  // 不包含created_at/updated_at
});

服务端配置建议

1. 自动时间戳管理 应在Supabase服务端配置自动填充时间戳的触发器：

• 新建记录时自动设置created_at
• 更新记录时自动更新updated_at

2. 同步策略优化

• 本地新建记录 → POST请求
• 服务端返回记录 → 包含完整时间戳
• 后续修改 → PATCH请求

版本兼容性说明

该同步机制在@legendapp/state 3.0.0-beta.23版本中表现正常，但开发者需要注意：

1. 时间戳字段的命名需与配置一致
2. 删除标记字段需正确配置
3. ID生成策略需保持一致性

总结

Legend-State的Supabase同步插件通过时间戳字段智能判断数据来源，开发者应避免在客户端手动设置时间戳字段，而应依赖服务端的自动填充机制。这种设计既保证了数据一致性，又实现了高效的增量同步。对于需要客户端生成ID的场景，务必确保新建记录时不包含服务端管理的字段。