Skip to content

Conversation

ByungJin-Lee
Copy link
Contributor

Summary

Add troubleshooting documentation for ReferenceError: FinalizationRegistry is
not defined error

Context

Related to issue: opennextjs/opennextjs-cloudflare#660
#issuecomment-2876460231

I encountered this error during ISR (Incremental Static Regeneration) processes
and was able to resolve it by updating the compatibility_date in the Wrangler
configuration. However, finding the solution required significant research
effort.

Changes

  • Added a new troubleshooting section for the FinalizationRegistry error
  • Included the fix: updating compatibility_date to 2025-05-05 or later
  • Added reference to official Cloudflare documentation

Motivation

This documentation will help other developers quickly find and resolve this
issue, reducing the time spen

@ByungJin-Lee ByungJin-Lee requested review from a team and james-elicx as code owners September 10, 2025 03:09
@vicb
Copy link
Contributor

vicb commented Sep 10, 2025

Thanks for your PR.

To be honest, I am not super keen on adding this to the Open Next because there is nothing specific to Open Next here.

However I don't see a better way now so I have approved the PR - maybe one thing we can do in the future is to enforce a minimum compatibility date.

@vicb vicb merged commit 65d8644 into opennextjs:main Sep 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants