mirror of
https://github.com/hanzoai/next.js.git
synced 2026-09-24 17:00:51 +00:00
docs: csr-bailout debugging (#86359)
I think maybe these others need a hint too, let's get started with, `errors/missing-suspense-with-csr-bailout` and `errors/prerender-error` - errors/blocking-route.mdx - errors/deopted-into-client-rendering.mdx - errors/dynamic-server-error.mdx - errors/next-prerender-crypto.mdx - errors/next-prerender-current-time.mdx - errors/next-prerender-sync-headers.mdx - errors/next-prerender-sync-params.mdx - errors/sync-dynamic-apis.mdx
This commit is contained in:
@@ -173,8 +173,19 @@ module.exports = {
|
||||
|
||||
This configuration option will be removed in a future major version.
|
||||
|
||||
## Debugging
|
||||
|
||||
If you're having trouble locating where `useSearchParams()` is being used without a Suspense boundary, you can get more detailed stack traces by running:
|
||||
|
||||
```bash
|
||||
next build --debug-prerender
|
||||
```
|
||||
|
||||
This provides unminified stack traces with source maps, making it easier to pinpoint the exact component and route causing the issue.
|
||||
|
||||
## Useful Links
|
||||
|
||||
- [`useSearchParams`](/docs/app/api-reference/functions/use-search-params)
|
||||
- [`connection`](/docs/app/api-reference/functions/connection)
|
||||
- [Dynamic Rendering guide](/docs/app/guides/caching#dynamic-rendering)
|
||||
- [Debugging prerender errors](/docs/app/api-reference/cli/next#debugging-prerender-errors)
|
||||
|
||||
@@ -131,9 +131,20 @@ export default function Page() {
|
||||
}
|
||||
```
|
||||
|
||||
## Debugging
|
||||
|
||||
For additional debugging information when troubleshooting prerender errors, you can run:
|
||||
|
||||
```bash
|
||||
next build --debug-prerender
|
||||
```
|
||||
|
||||
This provides unminified stack traces with source maps, making it easier to pinpoint the exact component and route causing the issue.
|
||||
|
||||
## Additional Resources
|
||||
|
||||
- [Handling Errors in Next.js](/docs/app/getting-started/error-handling)
|
||||
- [Data Fetching in Next.js](/docs/app/getting-started/fetching-data)
|
||||
- [Debugging prerender errors](/docs/app/api-reference/cli/next#debugging-prerender-errors)
|
||||
|
||||
If you continue to experience issues after trying these solutions, consider checking your server logs for more detailed error messages or reaching out to the Next.js community for support.
|
||||
|
||||
Reference in New Issue
Block a user