Error map

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

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.

backend spec — Firebase deploy: User code failed to load. Cannot determine backend specification (Google Cloud / Firebase)backend specCloud 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…App Engine — App Engine deploy failed: invalid app.yaml (runtime not supported / entrypoint / handlers) (Google Cloud / Firebase)App Enginerewrites — Firebase Hosting rewrite to a function returns 404 (wrong function name or region) (Google Cloud / Firebase)rewritesHttpsError — Firebase callable function error: FirebaseError: internal (unhandled exception in the function) (Google Cloud / Firebase)HttpsErrorcallable CORS — Firebase callable function blocked by CORS or 403: wrong region or function not invokable (Google Cloud / Firebase)callable CORSsecrets — Firebase Functions: secret value is undefined — secret not bound to the function or no access (Google Cloud / Firebase)secretsCannot find module — Cloud Functions: Error: Cannot find module 'X' (dependency missing at runtime) (Google Cloud / Firebase)Cannot find modulehosting — Firebase Hosting deploy: Could not find site / hosting target not configured (Google Cloud / Firebase)hostingcache — Firebase Hosting serves old files after deploy (CDN cache and Cache-Control headers) (Google Cloud / Firebase)cachedeploy — Firebase Functions deploy failed: Node runtime/engine unsupported or build error (Google Cloud / Firebase)deployContainer 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…API has not been used in project before or it is disabled — Google Cloud: 403 SERVICE_DISABLED — Cloud Resource Manager API has not been used in project 123456 before or it is disabled. Enable it by visiting (Google Cloud / Firebase)API has not been us…Your active project does not match the quota project in your local ADC — gcloud/ADC: WARNING: Your active project does not match the quota project in your local Application Default Credentials file (Google Cloud / Firebase)Your active project…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…ModuleNotFoundError — Cloud Functions Python: ModuleNotFoundError: No module named 'X' (requirements.txt) (Google Cloud / Firebase)ModuleNotFoundErrorCloud Run 403: Your client does not have permission to get URL — Cloud Run: Error: Forbidden — Your client does not have permission to get URL / from this server (Google Cloud / Firebase)Cloud Run 403: Your…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…custom domain — Firebase Hosting custom domain: SSL certificate pending / needs setup (DNS records) (Google Cloud / Firebase)custom domainTypeError 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…CORS: No Access-Control-Allow-Origin (Cloud Storage) — Browser: Access to fetch at 'https://storage.googleapis.com/bucket/file' from origin 'https://app.example.com' has been blocked by CORS policy (Google Cloud / Firebase)CORS: No Access-Con…no such function — SQLite: no such function: X (SQL)no such functionDRS — Org policy iam.allowedPolicyMemberDomains blocks the IAM binding (domain restricted sharing) (Google Cloud / Firebase)DRSCreateContainerConfigError — Kubernetes: CreateContainerConfigError — secret / configmap not found (Kubernetes)CreateContainerConf…ResourceInitializationError — ECS: ResourceInitializationError: unable to pull secrets or registry auth (AWS)ResourceInitializat…AADSTS7000222 — AADSTS7000222: The provided client secret keys for app are expired (Azure)AADSTS7000222MODULE_NOT_FOUND — Error: Cannot find module 'x' (MODULE_NOT_FOUND) (Node.js)MODULE_NOT_FOUNDModuleNotFoundError — ModuleNotFoundError: No module named 'x' (Python)ModuleNotFoundErrorImportError — ImportError: cannot import name 'x' from 'y' (Python)ImportErrorFirebase: 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…project — Firebase CLI: Failed to get Firebase project / Error: Not authorized, or HTTP Error 403 on project (Google Cloud / Firebase)projectDomain 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…404 — 404 on JS/CSS assets after a new deploy (HTTP)404CDN cache — CDN or browser serving stale content after a deploy (HTTP)CDN cacheemulators — Firebase Emulator Suite: port taken / app not connecting to the emulators (Google Cloud / Firebase)emulators

Directly related (10)

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.

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.

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.

HttpsErrorGoogle Cloud / Firebase

Firebase callable function error: FirebaseError: internal (unhandled exception in the function)

A callable function threw a non-`HttpsError` exception, so the client only sees a generic `internal` error.

callable CORSGoogle Cloud / Firebase

Firebase callable function blocked by CORS or 403: wrong region or function not invokable

The browser reports a CORS error calling `httpsCallable`, usually because the function URL/region is wrong or unauthenticated inv…

secretsGoogle Cloud / Firebase

Firebase Functions: secret value is undefined — secret not bound to the function or no access

`process.env.MY_SECRET` or `defineSecret().value()` returns undefined/empty at runtime.

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.

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.

cacheGoogle Cloud / Firebase

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

Visitors still see the previous version because assets or HTML are cached by the browser or Hosting's CDN.

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.

Two steps away (27)

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…

API has not been used in project before or it is disabledGoogle Cloud / Firebase

Google Cloud: 403 SERVICE_DISABLED — Cloud Resource Manager API has not been used in project 123456 before or it is disabled. Enable it by visiting

The Google API you called is not enabled for the project that the request is billed to.

Your active project does not match the quota project in your local ADCGoogle Cloud / Firebase

gcloud/ADC: WARNING: Your active project does not match the quota project in your local Application Default Credentials file

Application Default Credentials bill API usage to a different project than the one you have set as active, which can cause surpri…

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.

ModuleNotFoundErrorGoogle Cloud / Firebase

Cloud Functions Python: ModuleNotFoundError: No module named 'X' (requirements.txt)

The deployed Python function imports a package that wasn't installed from requirements.txt.

Cloud Run 403: Your client does not have permission to get URLGoogle Cloud / Firebase

Cloud Run: Error: Forbidden — Your client does not have permission to get URL / from this server

The Cloud Run service requires authentication and the caller has no valid identity token or the `roles/run.invoker` role.

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…

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.

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).

CORS: No Access-Control-Allow-Origin (Cloud Storage)Google Cloud / Firebase

Browser: Access to fetch at 'https://storage.googleapis.com/bucket/file' from origin 'https://app.example.com' has been blocked by CORS policy

A browser upload/download to Cloud Storage was blocked because the bucket's CORS configuration doesn't allow your origin, method…

no such functionSQL

SQLite: no such function: X

The query calls a function this SQLite build doesn't have.

DRSGoogle Cloud / Firebase

Org policy iam.allowedPolicyMemberDomains blocks the IAM binding (domain restricted sharing)

Adding allUsers or an outside-domain member to IAM failed because the organization restricts which identities can be granted acce…

CreateContainerConfigErrorKubernetes

Kubernetes: CreateContainerConfigError — secret / configmap not found

Kubernetes can’t build the container’s configuration — usually a referenced Secret, ConfigMap or key doesn’t exist in that namesp…

ResourceInitializationErrorAWS

ECS: ResourceInitializationError: unable to pull secrets or registry auth

Fargate couldn’t fetch the task’s secrets (Secrets Manager/SSM) or registry credentials before starting containers.

AADSTS7000222Azure

AADSTS7000222: The provided client secret keys for app are expired

The app registration’s client secret has expired, so service-to-service authentication fails.

MODULE_NOT_FOUNDNode.js

Error: Cannot find module 'x' (MODULE_NOT_FOUND)

Node can’t resolve the module path — the package isn’t installed, or a relative path/extension is wrong.

ModuleNotFoundErrorPython

ModuleNotFoundError: No module named 'x'

Python can’t find the module you import — it isn’t installed in the interpreter/virtualenv that’s running, or the import path is…

ImportErrorPython

ImportError: cannot import name 'x' from 'y'

The module was found, but the name you’re importing from it doesn’t exist — usually a version change or a circular import.

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.

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.

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.

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.

emulatorsGoogle Cloud / Firebase

Firebase Emulator Suite: port taken / app not connecting to the emulators

`firebase emulators:start` fails because ports are in use, or the app talks to production instead of the emulator.