Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions pages/cloudflare/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
31 changes: 31 additions & 0 deletions pages/cloudflare/known-issues.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
### Known issues

#### 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:

```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.