Next.js ISR silently failed on Cloudflare Workers due to three missing config steps
A developer running an AI documentation tracker on Cloudflare Workers via OpenNext discovered that Incremental Static Regeneration (ISR) had never performed a single background revalidation, despite months of the site appearing to function normally. Pages were refreshing only because frequent deployments invalidated the cache each time by changing the build ID, masking the underlying problem entirely. The root cause was three missing configuration elements required for Durable Object-backed ISR: a queue binding in open-next.config.ts, a Durable Object binding in wrangler.jsonc, and a Worker self-reference service binding, also in wrangler.jsonc. The commonly checked response header x-nextjs-cache: HIT proved misleading, as it appears whether a cache entry was repopulated by a user request or by a genuine background revalidation, making it structurally unable to confirm ISR health. Once all three bindings were correctly configured, logs showed 33 successful DO-driven re-renders with zero errors, which the developer describes as what a working ISR setup actually looks like.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in