Error map
backend spec Firebase deploy: User code failed to load. Cannot determine backend specification
Google Cloud / Firebase · layer 6, Platform & cloud
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.
Directly related (10)
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 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.
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.
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.
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…
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.
Cloud Functions: Error: Cannot find module 'X' (dependency missing at runtime)
The deployed function can't load a module that works locally.
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.
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.
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)
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…
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.
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…
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 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.
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: 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 — 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…
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: 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: f() missing 1 required positional argument: 'x'
A function was called without a required parameter.
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).
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…
SQLite: no such function: X
The query calls a function this SQLite build doesn't have.
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…
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…
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.
AADSTS7000222: The provided client secret keys for app are expired
The app registration’s client secret has expired, so service-to-service authentication fails.
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.
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…
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 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.
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.
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.
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 or browser serving stale content after a deploy
Users still see the old CSS, JS or HTML after you released a new version.
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.
Map another error
Popular: 500400403ORA-009331064Critical errorFileNotFoundException assemblyTypeError