Error map

cache Firebase Hosting serves old files after deploy (CDN cache and Cache-Control headers)

Google Cloud / Firebase · layer 6, Platform & cloud

Open the full error page →

Centre: this error. First ring: errors it is linked with (10). Outer ring: what those are linked with. Colours show the layer of a request each error belongs to. Click any dot to re-centre the map on it; hover to follow its connections. The centre dot opens the error page.

cache — Firebase Hosting serves old files after deploy (CDN cache and Cache-Control headers) (Google Cloud / Firebase)cacheDomain still resolves to the old IP (DNS propagation/cache) — Networking: DNS changed but the domain still resolves to the old IP — TTL and resolver caching ("propagation") (Networking)Domain still resolv…Firebase Hosting: Page Not Found on refresh (SPA routes) — Firebase Hosting: Page Not Found — This file does not exist and there was no 404.html or index.html found in the document root (Google Cloud / Firebase)Firebase Hosting: P…App Engine — App Engine deploy failed: invalid app.yaml (runtime not supported / entrypoint / handlers) (Google Cloud / Firebase)App EngineCloud CDN — Cloud CDN not caching: cache misses because of Set-Cookie, Cache-Control or missing cache mode (Google Cloud / Firebase)Cloud CDNcustom domain — Firebase Hosting custom domain: SSL certificate pending / needs setup (DNS records) (Google Cloud / Firebase)custom domain404 — 404 on JS/CSS assets after a new deploy (HTTP)404CDN cache — CDN or browser serving stale content after a deploy (HTTP)CDN cachehosting — Firebase Hosting deploy: Could not find site / hosting target not configured (Google Cloud / Firebase)hostingdeploy — Firebase Functions deploy failed: Node runtime/engine unsupported or build error (Google Cloud / Firebase)deploybackend spec — Firebase deploy: User code failed to load. Cannot determine backend specification (Google Cloud / Firebase)backend specPending validation — ACM certificate stuck in Pending validation (AWS)Pending validationlookup registry-1.docker.io: no such host — dial tcp: lookup registry-1.docker.io: no such host / Temporary failure in name resolution during docker build (Docker)lookup registry-1.d…DNS in pod — DNS not working inside a Kubernetes pod (could not resolve host / nslookup: can't resolve) (Kubernetes)DNS in podMinified React error — Error: Minified React error #31; visit https://react.dev/errors/31 for the full message (React)Minified React errorFirebase CLI: Authentication Error: Your credentials are no longer valid — Firebase CLI: Error: Authentication Error: Your credentials are no longer valid. Please run firebase login --reauth (Google Cloud / Firebase)Firebase CLI: Authe…Firebase: Your project must be on the Blaze (pay-as-you-go) plan — Firebase CLI: Error: Your project my-app must be on the Blaze (pay-as-you-go) plan to complete this command. Required API cloudbuild.googleapis.com can't be enabled until the upgrade is complete (Google Cloud / Firebase)Firebase: Your proj…Container failed to start — Cloud Run: The user-provided container failed to start and listen on the port defined provided by the PORT=8080 environment variable (Google Cloud / Firebase)Container failed to…This API method requires billing to be enabled — Google Cloud: 403 This API method requires billing to be enabled. Please enable billing on project and retry (Google Cloud / Firebase)This API method req…Cloud Functions: Build failed — Cloud Functions: Build failed: function.js does not exist / npm install failed with exit code 1 (Cloud Build step) (Google Cloud / Firebase)Cloud Functions: Bu…CSP violation — Refused to load the script because it violates the following Content Security Policy directive (JavaScript)CSP violationcf-cache-status: DYNAMIC — Cloudflare not caching: cf-cache-status DYNAMIC / BYPASS / MISS every time (Cloudflare)cf-cache-status: DY…502 Bad Gateway: failed_to_connect_to_backend — Google Cloud Load Balancing: 502 Bad Gateway — jsonPayload.statusDetails: failed_to_connect_to_backend / backend_connection_closed_before_data_sent_to_client (Google Cloud / Firebase)502 Bad Gateway: fa…CAA record forbids issuance — Let's Encrypt/CA: CAA record for example.com prevents issuance (SSL / TLS)CAA record forbids …domain mapping — Cloud Run domain mapping stuck: certificate provisioning pending (CertificatePending) (Google Cloud / Firebase)domain mappingManagedCertificate — GKE ManagedCertificate stuck Provisioning / FailedNotVisible (domain doesn't point to the load balancer) (Google Cloud / Firebase)ManagedCertificate404 — HTTP 404 Not Found (HTTP)404ChunkLoadError — ChunkLoadError: Loading chunk 123 failed. (JavaScript)ChunkLoadErrorNo query results for model — Laravel: Illuminate\Database\Eloquent\ModelNotFoundException: No query results for model [App\Models\Post] 5 (Laravel)No query results fo…520 — Cloudflare Error 520: Web Server Returned an Unknown Error (Cloudflare)520The request could not be satisfied — CloudFront: 403 ERROR — The request could not be satisfied (AWS)The request could n…Unable to prepare route for serialization. Uses Closure — Laravel: LogicException: Unable to prepare route [dashboard] for serialization. Uses Closure. (Laravel)Unable to prepare r…project — Firebase CLI: Failed to get Firebase project / Error: Not authorized, or HTTP Error 403 on project (Google Cloud / Firebase)projectTypeError arguments — TypeError: f() takes 1 positional argument but 2 were given (Python)TypeError argumentsTypeError missing arg — TypeError: f() missing 1 required positional argument: 'x' (Python)TypeError missing a…Invalid function argument — Terraform: Error: Invalid function argument — Invalid value for "list" parameter: list of string required / Call to function "lookup" failed (Terraform)Invalid function ar…Cloud Functions: Function failed on loading user code — Cloud Functions: Provided module can't be loaded / Function failed on loading user code. This is likely due to a bug in the user code (Google Cloud / Firebase)Cloud Functions: Fu…Cannot find module — Cloud Functions: Error: Cannot find module 'X' (dependency missing at runtime) (Google Cloud / Firebase)Cannot find modulerewrites — Firebase Hosting rewrite to a function returns 404 (wrong function name or region) (Google Cloud / Firebase)rewrites

Directly related (10)

Domain still resolves to the old IP (DNS propagation/cache)Networking

Networking: DNS changed but the domain still resolves to the old IP — TTL and resolver caching ("propagation")

You updated a DNS record, but resolvers and devices keep serving the old answer until its TTL expires.

Firebase Hosting: Page Not Found on refresh (SPA routes)Google Cloud / Firebase

Firebase Hosting: Page Not Found — This file does not exist and there was no 404.html or index.html found in the document root

A single-page app route returns 404 when opened directly or refreshed, because Firebase Hosting looks for a real file at that pat…

App EngineGoogle Cloud / Firebase

App Engine deploy failed: invalid app.yaml (runtime not supported / entrypoint / handlers)

`gcloud app deploy` rejects the configuration or the app fails its health check after deploy.

Cloud CDNGoogle Cloud / Firebase

Cloud CDN not caching: cache misses because of Set-Cookie, Cache-Control or missing cache mode

Responses keep missing the CDN cache, so every request reaches the origin.

custom domainGoogle Cloud / Firebase

Firebase Hosting custom domain: SSL certificate pending / needs setup (DNS records)

The custom domain stays in "Needs setup" or the certificate is pending because DNS doesn't match the required records.

404HTTP

404 on JS/CSS assets after a new deploy

The page loads old HTML that points to hashed asset files the new deploy removed.

CDN cacheHTTP

CDN or browser serving stale content after a deploy

Users still see the old CSS, JS or HTML after you released a new version.

hostingGoogle Cloud / Firebase

Firebase Hosting deploy: Could not find site / hosting target not configured

`firebase deploy --only hosting` can't resolve the site or target in firebase.json.

deployGoogle Cloud / Firebase

Firebase Functions deploy failed: Node runtime/engine unsupported or build error

`firebase deploy --only functions` fails because of the Node version, dependency or build step.

backend specGoogle Cloud / Firebase

Firebase deploy: User code failed to load. Cannot determine backend specification

The CLI couldn't execute your `functions` source to discover which functions it defines, so nothing is deployed.

Two steps away (28)

Pending validationAWS

ACM certificate stuck in Pending validation

ACM is waiting to see the DNS (or email) validation record — it wasn’t created, was created in the wrong DNS zone, or has a typo.

lookup registry-1.docker.io: no such hostDocker

dial tcp: lookup registry-1.docker.io: no such host / Temporary failure in name resolution during docker build

DNS isn’t working for the Docker daemon or inside build containers, so pulls and package downloads fail.

DNS in podKubernetes

DNS not working inside a Kubernetes pod (could not resolve host / nslookup: can't resolve)

Pods can’t resolve service names or external hosts — CoreDNS is down, blocked by NetworkPolicy, or the upstream resolver fails.

Minified React errorReact

Error: Minified React error #31; visit https://react.dev/errors/31 for the full message

A production React build threw an error whose message was shortened to a number.

Firebase CLI: Authentication Error: Your credentials are no longer validGoogle Cloud / Firebase

Firebase CLI: Error: Authentication Error: Your credentials are no longer valid. Please run firebase login --reauth

The Firebase CLI's saved login expired or was revoked.

Firebase: Your project must be on the Blaze (pay-as-you-go) planGoogle Cloud / Firebase

Firebase CLI: Error: Your project my-app must be on the Blaze (pay-as-you-go) plan to complete this command. Required API cloudbuild.googleapis.com can't be enabled until the upgrade is complete

Deploying Cloud Functions needs the Blaze plan because it relies on Cloud Build and Artifact Registry.

Container failed to startGoogle Cloud / Firebase

Cloud Run: The user-provided container failed to start and listen on the port defined provided by the PORT=8080 environment variable

Cloud Run started your container, but nothing listened on $PORT within the startup timeout — the app crashed, listens on another…

This API method requires billing to be enabledGoogle Cloud / Firebase

Google Cloud: 403 This API method requires billing to be enabled. Please enable billing on project and retry

The project has no active billing account, and the API/service needs one.

Cloud Functions: Build failedGoogle Cloud / Firebase

Cloud Functions: Build failed: function.js does not exist / npm install failed with exit code 1 (Cloud Build step)

The deployment's build step (Cloud Build) failed, so no new function version was created.

CSP violationJavaScript

Refused to load the script because it violates the following Content Security Policy directive

The page’s Content-Security-Policy doesn’t allow that script, style, image or connection source.

cf-cache-status: DYNAMICCloudflare

Cloudflare not caching: cf-cache-status DYNAMIC / BYPASS / MISS every time

Cloudflare isn’t caching the response — HTML isn’t cached by default, and cookies or Cache-Control headers from the origin preven…

502 Bad Gateway: failed_to_connect_to_backendGoogle Cloud / Firebase

Google Cloud Load Balancing: 502 Bad Gateway — jsonPayload.statusDetails: failed_to_connect_to_backend / backend_connection_closed_before_data_sent_to_client

The load balancer couldn't get a valid response from your backend and returned 502.

CAA record forbids issuanceSSL / TLS

Let's Encrypt/CA: CAA record for example.com prevents issuance

The domain's DNS CAA records do not list the certificate authority you asked, so the CA must refuse.

domain mappingGoogle Cloud / Firebase

Cloud Run domain mapping stuck: certificate provisioning pending (CertificatePending)

A custom domain mapped to Cloud Run never gets a certificate.

ManagedCertificateGoogle Cloud / Firebase

GKE ManagedCertificate stuck Provisioning / FailedNotVisible (domain doesn't point to the load balancer)

Google can't validate the domain because DNS doesn't reach the Ingress's IP, so the certificate never becomes Active.

404HTTP

HTTP 404 Not Found

The server can’t find anything at the requested URL.

ChunkLoadErrorJavaScript

ChunkLoadError: Loading chunk 123 failed.

A lazily loaded JavaScript chunk couldn’t be downloaded — usually because a new deployment removed the old hashed files.

No query results for modelLaravel

Laravel: Illuminate\Database\Eloquent\ModelNotFoundException: No query results for model [App\Models\Post] 5

`findOrFail`, `firstOrFail` or route-model binding couldn't find a record, so Laravel returns a 404.

520Cloudflare

Cloudflare Error 520: Web Server Returned an Unknown Error

Cloudflare connected to your origin, but the origin returned an empty, unknown or invalid response.

The request could not be satisfiedAWS

CloudFront: 403 ERROR — The request could not be satisfied

CloudFront refused or couldn’t serve the request — wrong alternate domain/certificate, blocked by origin access settings, a WAF/g…

Unable to prepare route for serialization. Uses ClosureLaravel

Laravel: LogicException: Unable to prepare route [dashboard] for serialization. Uses Closure.

`php artisan route:cache` failed because a route uses a closure, which can't be cached.

projectGoogle Cloud / Firebase

Firebase CLI: Failed to get Firebase project / Error: Not authorized, or HTTP Error 403 on project

The CLI can't find or access the project you passed, so deploy and use commands fail.

TypeError argumentsPython

TypeError: f() takes 1 positional argument but 2 were given

A function was called with more positional arguments than it accepts — very often a method missing `self`.

TypeError missing argPython

TypeError: f() missing 1 required positional argument: 'x'

A function was called without a required parameter.

Invalid function argumentTerraform

Terraform: Error: Invalid function argument — Invalid value for "list" parameter: list of string required / Call to function "lookup" failed

A built-in function got a wrong type/value (empty list, missing key, wrong type).

Cloud Functions: Function failed on loading user codeGoogle Cloud / Firebase

Cloud Functions: Provided module can't be loaded / Function failed on loading user code. This is likely due to a bug in the user code

The function started but could not import/initialise your code, so every invocation fails.

Cannot find moduleGoogle Cloud / Firebase

Cloud Functions: Error: Cannot find module 'X' (dependency missing at runtime)

The deployed function can't load a module that works locally.

rewritesGoogle Cloud / Firebase

Firebase Hosting rewrite to a function returns 404 (wrong function name or region)

A `rewrites` rule pointing at Cloud Functions or Cloud Run doesn't reach the service.