Common errors

Troubleshooting reference for problems you may hit while developing or running Cloud Functions.

This section collects errors and unexpected behaviour you may encounter while developing or running Cloud Functions, organised by category. If you don't find your error here, the Architecture and Tooling article is the best place to understand how the pieces fit together — most failures come from a tool or component being out of place.

In this section

  • Local development errors — Errors when running your Cloud Function locally with make run, including venv issues, Python version mismatches, and auto-reload surprises.
  • Docker errors — Errors involving the Docker container that backs the local Document Store, including permission and socket problems on macOS and Linux.