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:
Joseph
2025-11-21 11:11:12 +01:00
committed by GitHub
parent afec7a52dd
commit 897d021d96
2 changed files with 22 additions and 0 deletions
@@ -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)
+11
View File
@@ -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.