如何更新Cloudflare Durable Objects对象字段且不丢失原有数据？

核心逻辑 #

Durable Objects的put()方法会完全覆盖对应键的原有值，所以直接传入仅含目标字段的对象会丢失其他已有数据。正确的做法是先读取旧数据，合并新字段后再重新写入。

具体实现步骤 #

1. 在Durable Object类中实现专属的更新方法，利用Durable Object单线程处理请求的特性，保证操作的原子性，避免并发冲突。
2. 通过storage.get()获取目标键的原有对象，若键不存在则初始化空对象。
3. 将新字段值合并到原有对象中，保留未修改的字段。
4. 用storage.put()写入合并后的完整对象。

代码示例 #

export class MyDurableObject {
  constructor(state, env) {
    this.state = state;
  }

  async fetch(request) {
    const url = new URL(request.url);
    // 处理更新fieldA的请求
    if (url.pathname === '/update-fieldA') {
      const { fieldA } = await request.json();
      // 读取旧数据，不存在则初始化空对象
      const existingData = await this.state.storage.get('key0') || {};
      // 合并字段，保留原有其他字段
      const updatedData = { ...existingData, fieldA };
      // 写入更新后的数据
      await this.state.storage.put('key0', updatedData);
      return new Response(JSON.stringify(updatedData), { status: 200 });
    }

    // 其他请求处理逻辑
    return new Response('Not found', { status: 404 });
  }
}

关键注意点 #

• 必须在Durable Object内部执行「读-改-写」流程，不能在外部Worker中拆分操作，否则会出现并发竞态问题，比如两个请求同时读取旧值、各自修改后写入，导致数据覆盖丢失。
• 针对数组追加、数值递增等复杂操作，同样遵循先读再改再写的模式，Durable Object的单线程特性会保证整个操作的原子性。

内容的提问来源于stack exchange，提问作者tsitixe