Firebase "Functions codebase could not be analyzed successfully" in CI

To deploy, the CLI loads your functions code and reads the exported triggers. Analysis failed because the code did not build or threw at import time on the runner. The specific error is printed above this summary.

What this error means

A functions deploy fails with "Error: Functions codebase could not be analyzed successfully. It may have a syntax or runtime error" followed by the underlying error.

firebase

Error: Functions codebase could not be analyzed successfully. It may have a syntax or runtime error.

Common causes

TypeScript was not built before deploy

For a TypeScript functions project, the lib output must exist. If the predeploy build did not run, the CLI loads nothing valid.

Code throws at import time

Reading a missing environment variable or a bad import at module load throws while the CLI analyzes triggers.

How to fix it

Build functions in the predeploy step

Install and build the functions in CI before deploy.
Confirm the compiled output the main field points at exists.
Deploy after the build succeeds.

firebase.json

{
  "functions": {
    "source": "functions",
    "predeploy": ["npm --prefix functions ci", "npm --prefix functions run build"]
  }
}

Avoid throwing at module load

Read config lazily inside the handler, not at import time, so trigger discovery does not crash.

How to prevent it

Run the functions build as a predeploy step in CI.
Do not read required config at module top level.
Reproduce the analyze step locally with firebase deploy --only functions --dry-run.