Skip to content
Back to the playbook

Handling Durable Object WebSocket disconnects on deploy

Cloudflare Durable ObjectsCloudflare Workersrevision 1

Diagnostic tree

  1. In progressDurable Object WebSocket disconnects on deployEvery WebSocket connected to a Durable Object closes when that Durable Object's code is updated, because Cloudflare restarts the object to run the new code.
View the whole map (7 more steps)
  • Confirm disconnects line up with deploys
  • Check whether gradual deployments are enabled
  • Keep Worker/Durable Object API forward- and backward-compatible during rollout
  • Add automatic client reconnect logic
  • Disconnects don't line up with deploys — escalate
  • Deploy again and observe reconnect behaviour
  • Resolved

What to test

Durable Object WebSocket disconnects on deploy

Every WebSocket connected to a Durable Object closes when that Durable Object's code is updated, because Cloudflare restarts the object to run the new code.

What happened?