Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Αποτρέψτε το σφάλμα "too many connections" στα Server Actions του Next.js.
Κάθε απευθείας σύνδεση στην PostgreSQL δεσμεύει μια ξεχωριστή διεργασία λειτουργικού συστήματος (backend process) που καταναλώνει περίπου 10MB RAM. Σε serverless ή edge αρχιτεκτονικές (όπως τα Server Actions του Next.js), εκατοντάδες παράλληλες εκτελέσεις μπορούν να εξαντλήσουν το όριο max_connections μέσα σε κλάσματα του δευτερολέπτου.
Το Supavisor (ο σύγχρονος, γραμμένος σε Elixir connection pooler του Supabase) δρα ως διαμεσολαβητής, επιτρέποντας σε χιλιάδες concurrent clients να μοιράζονται έναν μικρό αριθμό πραγματικών συνδέσεων βάσης. Είναι ο shared pooler που υπάρχει σε κάθε project· το PgBouncer διατίθεται ως προαιρετικός dedicated pooler σε paid plans (τρέχει δίπλα στη βάση).
Χωρίς connection pooler, κάθε Serverless Function ανοίγει ένα νέο TCP socket προς τη βάση:
[1,000 Next.js Server Actions] ──► [1,000 TCP Συνδέσεις] ──► PostgreSQL: "FATAL: too many connections"Με το Supavisor:
[1,000 Next.js Server Actions] ──► [Supavisor Pooler (Port 6543)] ──► [Μόλις 25-50 Συνδέσεις] ──► PostgreSQLΤο Supabase παρέχει δύο ξεχωριστές θύρες σύνδεσης:
BEGIN ... COMMIT).LISTEN/NOTIFY, ή προσωρινοί πίνακες (TEMP TABLE).supabase db push, prisma migrate), cron scripts και διεργασίες με LISTEN/NOTIFY.Στο αρχείο .env, διατηρούμε πάντα δύο παραμέτρους σύνδεσης:
# 1. Για την εφαρμογή (Transaction Mode μέσω Supavisor)
DATABASE_URL="postgres://postgres.project:secret@aws-0-eu-central-1.pooler.supabase.com:6543/postgres?pgbouncer=true"
# 2. Για εργαλεία Migrations (Direct Session Mode)
DIRECT_URL="postgres://postgres.project:secret@aws-0-eu-central-1.pooler.supabase.com:5432/postgres"Κατά την αρχικοποίηση του database client (π.χ. postgres.js ή Drizzle), απενεργοποιούμε τα prepared statements για συμβατότητα με το Transaction Mode:
// lib/db/index.ts
import postgres from 'postgres'
const connectionString = process.env.DATABASE_URL!
// Στο Transaction Mode ορίζουμε prepare: false
export const sql = postgres(connectionString, {
prepare: false,
max: 10, // Μέγιστος αριθμός συνδέσεων ανά serverless worker
idle_timeout: 20,
})Ένα συχνό λάθος είναι ο ορισμός υπερβολικά μεγάλου μεγέθους pool. Ο εμπειρικός κανόνας της PostgreSQL είναι:
Pool size = (CPU cores × 2) + spindle count
Σε ένα VPS με 4 CPU cores και NVMe δίσκο, ένα pool μεγέθους 15 έως 25 συνδέσεων προσφέρει σημαντικά υψηλότερο throughput από ένα pool 200 συνδέσεων, καθώς αποτρέπει το CPU context switching.
| Χαρακτηριστικό | Transaction Mode (6543) | Session Mode (5432) |
|---|---|---|
| Ιδανικό για | Next.js Server Components & Actions | CLI Migrations, Long-running Daemons |
| Max Concurrent Clients | 10.000+ ταυτόχρονοι χρήστες | Περιορισμένο από το max_connections (π.χ. 60-100) |
| Prepared Statements | Απαιτεί prepare: false ή cache disabled | Πλήρως υποστηριζόμενα |
| LISTEN / NOTIFY | Δεν υποστηρίζεται | Πλήρως υποστηριζόμενο |
| Χρήση Μνήμης Server | Εξαιρετικά χαμηλή | Αυξάνεται γραμμικά με κάθε πελάτη |
DATABASE_URL port 6543 transaction mode via Supavisor VS DIRECT_URL port 5432 direct session modeNext.js Server Action με 1.000 παράλληλες εκτελέσεις και prepare false. Ποια θύρα χρησιμοποιείτε — 6543 ή 5432;
max_connections.Supavisor μοιράζει χιλιάδες clients σε λίγες πραγματικές συνδέσεις μέσω του transaction pooler στη θύρα 6543.prepare: false, χωρίς LISTEN/NOTIFY ή TEMP TABLE.5432 κρατά ανοιχτό το socket και προορίζεται μόνο για migrations, cron scripts και LISTEN/NOTIFY.