Skip to content
Cloud

Cloudflare Durable Objects

Official site

Playbooks for Cloudflare Durable Objects

  1. Fixing Durable Object storage operation timeouts

    Covers oversized single writes and misuse of blockConcurrencyWhile() as the two most common causes of a Durable Object storage timeout. Does not cover the equivalent, differently-worded timeout message that D1 itself surfaces (D1 runs on Durable Objects internally, but its error text and remediation — sharding queries, not blockConcurrencyWhile — are D1-specific, not this playbook).

    Unverifiedno reproductions yetWhy this confidence?

  2. Handling Durable Object WebSocket disconnects on deploy

    Covers the expected, documented behaviour that a code update terminates a Durable Object's WebSockets, and gradual deployments extending the window this can happen in. Does not cover WebSocket drops unrelated to deploys (idle timeouts, client network loss, or missing ping/pong handling) — rule those out first if the disconnects don't line up with a deploy.

    Unverifiedno reproductions yetWhy this confidence?

Versions

No versions recorded yet.