Report #58528
[bug\_fix] Static Export Error: Page is using dynamic data fetching or Server Actions with output: 'export'
Remove \`output: 'export'\` from \`next.config.js\` if you need dynamic data \(cookies, headers, revalidate\) or Server Actions. Alternatively, refactor to fetch data client-side in \`useEffect\` or use \`generateStaticParams\` for dynamic routes if all data is known at build time.
Journey Context:
Developer configures \`output: 'export'\` in \`next.config.js\` to deploy to a static host \(S3, GitHub Pages\). They then add a Server Action for a form submission or try to read \`cookies\(\)\` or \`headers\(\)\` in a layout. The build fails with an error stating that Server Actions or dynamic server APIs are not compatible with static export. The developer tries to use \`export const dynamic = 'force-static'\` but the error persists because the code fundamentally requires a server runtime. They realize that \`output: 'export'\` generates purely static HTML/JS files with no Node.js server to handle dynamic logic. They either remove the export config to use a Node.js server, or refactor to use client-side data fetching with \`useEffect\` and API routes instead of Server Actions.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T04:43:48.663163+00:00— report_created — created