Cloudflare Durable Objects · 按实体组织协调与可恢复状态

@public/durable-objects

查看空间 →

构建、调试或审查Durable Objects,将需要共享协调状态的房间、用户或业务实体映射到对象,核对确定性路由、持久存储、初始化、RPC、闹钟及WebSocket生命周期。结合迁移、并发边界和目标运行时测试设计可恢复行为。采用 Apache-2.0 许可证。

能力与使用条件

适用场景

  • 设计按实体隔离的有状态协调服务
  • 审查对象存储、初始化与异步交错
  • 实现闹钟或WebSocket并验证重启恢复

输入要求

  • 实体边界、对象路由与实际业务不变量
  • 存储后端、类导出或迁移配置和兼容目标
  • RPC、外部调用、闹钟及连接生命周期要求

输出结果

  • 对象划分、路由和持久状态方案
  • 并发、恢复、重试及连接生命周期检查清单
  • 迁移与目标运行时测试建议

前置条件

  • 明确需要协调的实体与不变量,并具备兼容Workers项目
  • 远程访问具备对应权限,实施和验证遵循项目容器及授权约定

不适用场景与限制

  • 单线程不自动消除跨await的交错或外部副作用竞争;跨对象操作不自动形成事务,应按存储门禁和事务API设计
  • 确定性对象名不完成租户鉴权,内存状态不是持久状态;请求身份与实体访问权限仍需服务端校验
  • 新SQLite类与已有KV后端应分别核对迁移,RPC不意味着HTTP处理器无效;blockConcurrencyWhile适用边界须按实际初始化需求判断
  • 闹钟替换、重试、WebSocket休眠和重启可能影响业务状态,外部副作用需幂等设计;真实部署位置、限制和权限以当前平台契约为准
  • 下载链接为固定提交的完整仓库快照,使用其中 skills/durable-objects 目录。配图是说明性示例。

说明性示例

  • 为这个按房间协调的服务核对Durable Object划分和路由,检查跨await状态修改、持久化及外部副作用;给出闹钟重试、对象重启和WebSocket休眠后的恢复验证方案。

资料依据

  • https://github.com/cloudflare/skills/blob/cbf893b954222276bf1af57e5f23379231e0efb9/skills/durable-objects/SKILL.md
  • https://github.com/cloudflare/skills/blob/cbf893b954222276bf1af57e5f23379231e0efb9/LICENSE

外部资源

内容由外部网站提供,平台不保证第三方文件的完整性、可用性或安全性。

外部文件的访问权限由第三方管理,本站无法限制其地址的访问。