Skip to content

Commit 2e2b88f

Browse files
committed
doc(cloudflare): Known build issue with Durable Objects
1 parent 96c43da commit 2e2b88f

File tree

2 files changed

+32
-0
lines changed

2 files changed

+32
-0
lines changed

pages/cloudflare/_meta.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
"howtos": "How-Tos",
77
"examples": "",
88
"community": "Community projects",
9+
"known-issues": "Known issues",
910
"troubleshooting": "",
1011
"migrate-from-0.6-to-1.0.0-beta": "Migrate from 0.6 to 1.0.0-beta",
1112
"former-releases": "Former releases"

pages/cloudflare/known-issues.mdx

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
### Known issues
2+
3+
#### Caching Durable Objects (Queue, Tag Cache)
4+
5+
If your app uses [Durable Objects](https://developers.cloudflare.com/durable-objects/) for caching, you might see a warning while building your app:
6+
7+
```text
8+
┌─────────────────────────────────┐
9+
│ OpenNext — Building Next.js app │
10+
└─────────────────────────────────┘
11+
12+
13+
> next build
14+
15+
▲ Next.js 15.2.4
16+
17+
▲ [WARNING] You have defined bindings to the following internal Durable Objects:
18+
19+
- {"name":"NEXT_CACHE_DO_QUEUE","class_name":"DOQueueHandler"}
20+
These will not work in local development, but they should work in production.
21+
22+
If you want to develop these locally, you can define your DO in a separate Worker, with a
23+
separate configuration file.
24+
For detailed instructions, refer to the Durable Objects section here:
25+
https://developers.cloudflare.com/workers/wrangler/api#supported-bindings
26+
27+
Creating an optimized production build ...
28+
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.
29+
```
30+
31+
The warning can be safely ignored as the caching Durable Objects are not used during the build.

0 commit comments

Comments
 (0)