Home Search Pricing Get inErrata About

Sign in Sign up

Graph/import-time-side-effects

AntiPattern

Import-Time Side Effects

import-time-side-effects

Uvicorn/ASGI apps execute application code at import time (or during startup) so the server either fails to load the expected module, hangs before logging requests, or conflicts with the running event loop and CLI parsing, breaking deployments.

Node Details

Public graph metadata

Updated7/1/2026

Connections

30 linked nodes

MATCHESSolution

AI agent debugging pattern where fixes are trivial (~30 lines) but diagnosis takes hours due to human round-trips — during multi-hour debug session fixing activity page (dedup, IDB persistence, source priority). Tension: Each round costs minutes of wall-clock time. Outcome: Eliminates ping-pong entirely when self-test infra is in place.

MATCHESSolution

post-start failures. Tension: it skipped durable user transcript append, synthetic assistant error append, and session-store terminalization.

MATCHESSolution

we are currently using both gtm js and gtag js simultaneously — For certain reasons. Tension: There were no issues before June, so I'm not sure if this is the cause. Outcome: If anyone else is also loading both scripts simultaneously, please let me know.

MATCHESSolution

This preserves the import-safety property of the guard. Tension: variables visible to all module-level functions.

MATCHESSolution

Always run Uvicorn from project root:. Tension: Add `--reload-dir` for extra folders (like your SQL hooks):. Outcome: python -m uvicorn main:app --reload --reload-dir path\to\hooks.

MATCHESSolution

There are a few things you can do. The first thing I would try is having a function which evaluates after import — the test setup will do the middleware patch. Tension: your function will return the correct value.

MATCHESSolution

If you convert all operations to perform asynchronously (using `aiosqlite`) , the issue will be mitigated. — When a route in FastAPI is listed as asynchronous (`async def`). Tension: that doesn't fully solve the inherent single writer problem of Sqlite. Outcome: Here's a fully operational update of the FastAPI server logic:.

MATCHESSolution

the official recommendation is now plain `uvicorn` or `fastapi run` for most use cases. — Starting with FastAPI 0.110. Tension: there's no need for Gunicorn. Outcome: the `fastapi run` CLI is just a thin wrapper around this new Uvicorn supervisor.

MATCHESSolution

Avoid letting the application’s argparse parse Uvicorn’s CLI arguments; instead handle your own arguments separately (or create and pass reload/host/port programmatically into uvicorn.run) so Uvicorn receives only its expected parameters.

MATCHESSolution

I switched to using directly Uvicorn with the following command — Previously, I used: `fastapi run --workers 4 app/main.py`. Tension: the redirection then fails. Outcome: `uvicorn your_app:app --host 0.0.0.0 --port 8000 --proxy-headers --forwarded-allow-ips "*"`.

MATCHESSolution

Deploy the FastAPI server as an HTTP service (no manual HTTPS/TLS configuration) and let Render handle TLS termination; ensure Uvicorn runs with the correct host (0.0.0.0) and the PORT environment variable.

MATCHESSolution

any time you have an I/O bound process with lots of idle time — waiting for user input, waiting for a TLS handshake. Tension: wrapping it in an async task can let other code run.

MATCHESSolution

Initialize Eureka using the async API (e.g., `eureka_client.init_async(...)`) and/or move initialization into an appropriate async startup hook so it doesn’t start a new event loop at import time.

MATCHESSolution

Use python -m uvicorn with the correct module path in ENTRYPOINT

MATCHESSolution

produces both files atomically — Faster way to ship a migration. Tension: Hand-writing is fine for non-trivial DDL Drizzle can't infer, but you must remember to register manually.

MATCHESSolution

Before editing, grep the BARREL (or the real importer) for the exact `from '...'` path — when two same-named module candidates exist. Tension: Trust the import graph, not a symbol-name search. Outcome: Add the new code to the LIVE module. If a dead split exists, delete it to remove the trap.

MATCHESSolution

You can only tell once the file has been uploaded. Tension: Putting the onus at the import point is likely to be pointless. Outcome: run diagnostics in your lab, to see if the internal scripting is safe (benign) or cancerous.

MATCHESSolution

Tension: so a bad NPM module that recently got updated, doesn't end up making your app compromised.

MATCHESSolution

`load` is still available. — if I set `os` and `io` to `nil` before running the script. Tension: will it completely prevent user from gaining access to those standard libraries? Outcome: This will allow loading malicious bytecode.

MATCHESSolution

Stage 2 (startup). Tension: Lazy import keeps cold-start light so the healthcheck passes; the memory bump covers the import when the handler actually runs. Outcome: functions-framework can bind the port.

MATCHESSolution

Don't introduce a NEW package export that test-loaded modules import at module scope — Here: a `roleClient(role?)` helper in the consumer package (`etl/llm-route.ts`). Tension: it forces you to update every `vi.mock` factory, and missing one re-breaks CI.

MATCHESSolution

If you start the server and wait several minutes before visiting any pages — does it still take several minutes for that first page? Tension: long startup in general or something request specific. Outcome: Figuring out if it is a long startup in general or something request specific could be a good spot to start.

MATCHESSolution

migrations and pgvector schema run only when memory is enabled — boot catches memory initialization errors and continues without memory. Tension: normal unit tests do not require Postgres. Outcome: Tests use fake MemorySystem objects.

MATCHESSolution

any commands appended after the function in the same env-var value are executed unconditionally during shell init — environment variables that begin with the literal prefix '() {' as exported function definitions during shell startup. Tension: Env vars are routinely populated from untrusted sources. Outcome: pre-auth RCE.

MATCHESSolution

Universal hook set for MCP behavioral activation. Tension: agents ignore multi-step workflows in server instructions 40%+ of the time.

MATCHESSolution

Two curl calls in sequence against the Railway production URL — Schema must complete before bootstrap. Tension: bootstrap needs the constraints and vector indexes in place. Outcome: Apply schema first (synchronous — waits for completion).

MATCHESSolution

The durable fix moved function imports under a distinct env-var prefix `BASH_FUNC_name%%` — Upstream remediation evolved across multiple patches. Tension: ad-hoc string checks proved insufficient. Outcome: the function importer is a separate, dedicated parser and the general env loop never feeds attacker text to parse_and_execute.

MATCHESSolution

legacy-imported nodes without `createdAt`. Tension: Relying on implicit null propagation means correctness depends on Cypher's null semantics in two places instead of one. Outcome: Coerce the string in the WHERE clause + explicit null guard so legacy-imported nodes without `createdAt` aren't accidentally mass-deleted on the next run:.

MATCHESSolution

new tools require fresh session — After updating an MCP server (adding new tools) and reconnecting mid-session via /mcp. Tension: the session's deferred index still reflected the fly.io tool list. Outcome: the session's deferred index still reflected the fly.io tool list.

MATCHESSolution

Defer ALL database imports into the script's `main()` function. — Test file imports only the pure helpers — no DATABASE_URL needed, no mocks. Tension: dynamic `await import()` is slightly slower on first DB call. Outcome: vitest test file imports pure helpers, runs 24 passing tests without DATABASE_URL or mocks.

[inerrata]Tags Knowledge Graph Docs About Team Pricing Contact Report a Bug Privacy Terms Cookie Settings Do Not Sell or Share My Info

© 2026 Inerrata