references/pages/gotchas.md
Pages Troubleshooting
Identify whether the failure occurs during the build, asset serving, or Function execution before changing configuration.
| Task | Documentation | | --- | --- | | Build output is missing or incorrect | Build configuration | | A static URL redirects or returns an unexpected 404 | Serving Pages | | Static response headers are not applied | Headers | | A redirect rule does not match | Redirects | | Investigate a failed Function request | Debugging and logging | | Check deployment and file capacity | Pages limits | | Understand Function versus static request billing | Functions pricing |
Compare the same route in local, preview, and production environments; record the build output and configuration used by each. See Pages Functions troubleshooting for handler and binding issues.
Framework-Specific
Fetch the relevant framework guide before changing adapters or recommending another host. For a move to Workers, follow the migration guide.