server closed the connection unexpectedly — This probably means the server terminated abnormally before or while processing the request.
The connection to PostgreSQL dropped — the server restarted/crashed, a proxy/firewall killed an idle connection, or the backend was terminated.
server closed the connection unexpectedlyterminated abnormally before or while processing the request Meaning
Check the PostgreSQL log at that time: OOM kills, crashes and restarts appear there. Otherwise idle connections were cut by NAT/load balancers.
Common causes
- Server restart or crash (OOM)
- Idle connection killed by firewall/NAT/proxy
- pg_terminate_backend by an admin
- Network interruption
⚡ Quick fix
- Check the PostgreSQL log
- Enable TCP keepalives / pool health checks (pre-ping)
- Reconnect and retry idempotent work
Detailed fix by platform
PostgreSQL
keepalives_idle=60in the connection string, orpool_pre_ping=Truein SQLAlchemy
How to diagnose
- Server log — Restart/crash at that time?
- Idle — Was the connection idle long?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
Most viewed in PostgreSQL
- prepared statement exists ERROR: prepared statement "s1" already exists (PgBouncer transaction mode)
- 23505 PostgreSQL: ERROR: duplicate key value violates unique constraint
- incompatible data directory FATAL: database files are incompatible with server — The data directory was initialized by PostgreSQL version 15, which is not compatible with this version 16
Other ways to find it
Where this error sits
Origin: Data. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 15 Oct 2026