From 2e2b88fe354c5729081dfdfec83c9083dc09eb74 Mon Sep 17 00:00:00 2001 From: Victor Berchet Date: Fri, 4 Apr 2025 11:48:42 +0200 Subject: [PATCH 1/3] doc(cloudflare): Known build issue with Durable Objects --- pages/cloudflare/_meta.json | 1 + pages/cloudflare/known-issues.mdx | 31 +++++++++++++++++++++++++++++++ 2 files changed, 32 insertions(+) create mode 100644 pages/cloudflare/known-issues.mdx diff --git a/pages/cloudflare/_meta.json b/pages/cloudflare/_meta.json index e509557..d00ded9 100644 --- a/pages/cloudflare/_meta.json +++ b/pages/cloudflare/_meta.json @@ -6,6 +6,7 @@ "howtos": "How-Tos", "examples": "", "community": "Community projects", + "known-issues": "Known issues", "troubleshooting": "", "migrate-from-0.6-to-1.0.0-beta": "Migrate from 0.6 to 1.0.0-beta", "former-releases": "Former releases" diff --git a/pages/cloudflare/known-issues.mdx b/pages/cloudflare/known-issues.mdx new file mode 100644 index 0000000..52cad2c --- /dev/null +++ b/pages/cloudflare/known-issues.mdx @@ -0,0 +1,31 @@ +### Known issues + +#### Caching Durable Objects (Queue, Tag Cache) + +If your app uses [Durable Objects](https://developers.cloudflare.com/durable-objects/) for caching, you might see a warning while building your app: + +```text +┌─────────────────────────────────┐ +│ OpenNext — Building Next.js app │ +└─────────────────────────────────┘ + + +> next build + + ▲ Next.js 15.2.4 + +▲ [WARNING] You have defined bindings to the following internal Durable Objects: + + - {"name":"NEXT_CACHE_DO_QUEUE","class_name":"DOQueueHandler"} + These will not work in local development, but they should work in production. + + If you want to develop these locally, you can define your DO in a separate Worker, with a + separate configuration file. + For detailed instructions, refer to the Durable Objects section here: + https://developers.cloudflare.com/workers/wrangler/api#supported-bindings + + Creating an optimized production build ... +workerd/server/server.c++:1951: warning: A DurableObjectNamespace in the config referenced the class "DOQueueHandler", but no such Durable Object class is exported from the worker. Please make sure the class name matches, it is exported, and the class extends 'DurableObject'. Attempts to call to this Durable Object class will fail at runtime, but historically this was not a startup-time error. Future versions of workerd may make this a startup-time error. +``` + +The warning can be safely ignored as the caching Durable Objects are not used during the build. \ No newline at end of file From 9fecc9d2cdf8a5bb44604638a2997b63f59988b0 Mon Sep 17 00:00:00 2001 From: Victor Berchet Date: Fri, 4 Apr 2025 11:52:22 +0200 Subject: [PATCH 2/3] fixup! format --- pages/cloudflare/known-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/cloudflare/known-issues.mdx b/pages/cloudflare/known-issues.mdx index 52cad2c..6b00ddf 100644 --- a/pages/cloudflare/known-issues.mdx +++ b/pages/cloudflare/known-issues.mdx @@ -28,4 +28,4 @@ If your app uses [Durable Objects](https://developers.cloudflare.com/durable-obj workerd/server/server.c++:1951: warning: A DurableObjectNamespace in the config referenced the class "DOQueueHandler", but no such Durable Object class is exported from the worker. Please make sure the class name matches, it is exported, and the class extends 'DurableObject'. Attempts to call to this Durable Object class will fail at runtime, but historically this was not a startup-time error. Future versions of workerd may make this a startup-time error. ``` -The warning can be safely ignored as the caching Durable Objects are not used during the build. \ No newline at end of file +The warning can be safely ignored as the caching Durable Objects are not used during the build. From 7a68c1fa89cc197aae591d40eac88b81dea524f1 Mon Sep 17 00:00:00 2001 From: Victor Berchet Date: Fri, 4 Apr 2025 12:07:05 +0200 Subject: [PATCH 3/3] Update pages/cloudflare/known-issues.mdx --- pages/cloudflare/known-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/cloudflare/known-issues.mdx b/pages/cloudflare/known-issues.mdx index 6b00ddf..ea8f040 100644 --- a/pages/cloudflare/known-issues.mdx +++ b/pages/cloudflare/known-issues.mdx @@ -1,6 +1,6 @@ ### Known issues -#### Caching Durable Objects (Queue, Tag Cache) +#### Caching Durable Objects (`DOQueueHandler` and `DOShardedTagCache`) If your app uses [Durable Objects](https://developers.cloudflare.com/durable-objects/) for caching, you might see a warning while building your app: