Troubleshoot Healthcheck Next.js
- A route appears cached: export
dynamic,revalidate, andfetchCacheas shown in Quick start. - Response is 401: verify the exact Authorization header and, for IP rules, the configured proxy header.
- Factory throws
HEALTHCHECK_INVALID_CONFIG: provide at least one policy; do not combine bearer and Basic; enabletrustProxyfor IP/CIDR; use IPv4. - Node probes fail at the edge: set route runtime to
nodejsor remove Node-only checks. - Metrics are empty: register collectors; check-local metrics are not report-level exporter series.