...
Eroare System Design · Baza de date: conexiuni, lock-uri, interogări lente

FATAL: sorry, too many clients already

Pe scurt

PostgreSQL a atins `max_connections` (implicit 100) și refuză conexiuni noi. Apare tipic după scalarea aplicației: fiecare instanță are propriul pool, iar suma lor depășește limita. Calculează instanțe × mărimea pool-ului, micșorează pool-urile și pune un pooler (PgBouncer) în față.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare conexiune PostgreSQL e un proces separat pe server, cu memoria lui, de aceea numărul lor e limitat de max_connections. Când limita e atinsă, orice conexiune nouă primește FATAL: sorry, too many clients already (sau remaining connection slots are reserved for non-replication superuser connections, când rămân doar sloturile rezervate).

În system design, eroarea apare aproape mereu la scalare orizontală. Un pool de 20 de conexiuni pe instanță e rezonabil pentru un server, dar 20 de instanțe (sau un autoscaling care ajunge la maxim) deschid 400 de conexiuni. Funcțiile serverless sunt și mai periculoase: fiecare execuție concurentă poate deschide propria conexiune.

Mărirea max_connections la mii de conexiuni nu e soluția: fiecare consumă memorie și procesor pentru gestiune. Soluția e să numeri conexiunile la nivel de sistem: pool-uri mai mici pe instanță și un pooler (PgBouncer, RDS Proxy) care multiplexează mulți clienți pe puține conexiuni reale.

De ce apare: cauzele frecvente

1Pool mare pe fiecare instanță, multe instanțe

Greșit
spring:
  datasource:
    hikari:
      maximum-pool-size: 20   # × 20 instanțe = 400
Corect
spring:
  datasource:
    url: jdbc:postgresql://pgbouncer:6432/magazin
    hikari:
      maximum-pool-size: 4    # × 20 = 80

Suma pool-urilor trebuie să încapă în limita bazei; PgBouncer permite mai mulți clienți decât conexiuni reale.

2Conexiune nouă la fiecare cerere (serverless)

Greșit
def handler(event, context):
    con = psycopg2.connect(DSN)   # la fiecare apel
Corect
con = None
def handler(event, context):
    global con
    if con is None or con.closed:
        con = psycopg2.connect(PROXY_DSN)   # prin RDS Proxy / PgBouncer

Conexiunea refolosită între apeluri și un proxy de conexiuni țin numărul total sub control.

Repară tu

Repară eroarea, direct în pagină

Aplicația a fost scalată la 20 de instanțe, fiecare cu un pool de 20 de conexiuni, iar PostgreSQL (max_connections = 100) răspunde cu FATAL: sorry, too many clients already. Fă cele trei calcule din tab-ul Estimări: conexiunile totale, pool-ul maxim pe instanță și conexiunile reale cu PgBouncer.

Indiciu

Numărul de conexiuni la bază e suma pool-urilor tuturor instanțelor.

Alte forme ale mesajului

  • FATAL: remaining connection slots are reserved for non-replication superuser connections
  • org.postgresql.util.PSQLException: FATAL: sorry, too many clients already
  • psycopg2.OperationalError: FATAL: sorry, too many clients already

Cum o eviți pe viitor

  • Calculează la fiecare schimbare de scalare: instanțe maxime × pool pe instanță.
  • Ține pool-urile mici (des, câteva conexiuni pe nucleu de bază ajung).
  • Pune PgBouncer sau un proxy gestionat în fața bazei.
  • Monitorizează pg_stat_activity și alertează la 80% din max_connections.

Întrebări frecvente

Cât de mare să fie pool-ul?

Mai mic decât crezi. Baza nu execută mai multe interogări simultan decât îi permit nucleele și discurile; conexiunile în plus doar așteaptă. Pornește de la câteva conexiuni pe instanță și măsoară.

Pot mări max_connections la 1.000?

Tehnic da, dar fiecare conexiune costă memorie, iar performanța scade la multe conexiuni active. Un pooler rezolvă problema mai ieftin.

Erori înrudite

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață System Design de la zero, cu exerciții la fiecare lecție

Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.