FATAL: too many connections for role "app_user"PostgreSQL Rol Bağlantı Limiti Aşımı: Nedenleri, Acil Limit Artırımı ve Rol Bazlı Havuzlama
ALTER ROLE ... CONNECTION LIMIT kısıtlamasının uygulama pod artışıyla dolması, acil limit düzenleme ve PgBouncer kullanıcı bazlı havuz mimarisi.
Teshis & Ayırt Etme Protokolü (Disambiguation)
PG 14 - 17 ortamında istemci ile veritabanı arasındaki bağlantı, soket veya ağ zaman aşımı durumunu ifade eder.
Sorgu optimizasyonu veya veri bozulması değildir; bağlantı ve kimlik doğrulama katmanına aittir.
Operasyonel Kanıt & Laboratuvar Doğrulaması
Gerçek veritabanı sürümlerinde test edilmiş teknik sınırlar ve güvenlik protokolü.
PostgreSQL 14.10, 15.6, 16.4, 17.11 (Ubuntu 24.04)
SUPERUSER veya CREATEROLE
ALTER ROLE app_user CONNECTION LIMIT 50;
Rol bağlantı sayısının CONNECTION LIMIT değerinin altına inmesi
PostgreSQL Docs: ALTER ROLE Connection Limits
Hata mesajı bir semptomdur, kök neden değildir. Sunucuyu veya veritabanı servisini körü körüne yeniden başlatmayın! Önce aşağıdaki salt-okunur (read-only) teşhis sorgularını çalıştırarak gerçek arıza modunu tespit edin; ardından kontrollü müdahaleye geçin.
▸Belirti
Belirli bir mikroservis bağlantı kurmaya çalıştığında reddedilirken diğer servisler sorunsuz çalışır:
FATAL: too many connections for role "app_user"▸Sahada Ne Görürsün?
Süper kullanıcı ve diğer roller bağlanabilir. Ancak app_user kullanan pod'lar bağlantı havuzu zaman aşımına (HikariPool - Connection is not available) uğrar.
▸Kök Neden Matrisi
| Olasılık | Kök Neden | Açıklama |
|---|---|---|
| %65 | Uygulama Pod Ölçeklenmesi | CONNECTION LIMIT 20 belirlenmiştir. Pod sayısı 2'den 6'ya çıkınca kota anında patlar. |
| %25 | Bağlantı Sızıntısı (Connection Leak) | Uygulama idle oturumları kapatmamış, kotayı doldurmuştur. |
| %10 | Katı Limit Politikası | DBA limiti trafik artışına göre güncellenmemiştir. |
▸ACİL RUNBOOK (0-5dk)
-- 1. Rol limitini ve mevcut oturumları gör
SELECT rolname, rolconnlimit FROM pg_roles WHERE rolname = 'app_user';
SELECT count(*), state FROM pg_stat_activity WHERE usename = 'app_user' GROUP BY state;
-- 2. Acil kotayı geçici kaldır (-1 = sınırsız)
ALTER ROLE app_user CONNECTION LIMIT -1;
-- 3. Boştaki oturumları sonlandır
SELECT pg_terminate_backend(pid) FROM pg_stat_activity
WHERE usename = 'app_user' AND state = 'idle' AND state_change < now() - interval '5 minutes';▸KALICI BLUEPRINT
- 1PgBouncer Havuzlama: İstemciler doğrudan değil PgBouncer üzerinden bağlanmalıdır.
- 2Rol Limiti: Pod Sayısı x Havuz x 1.2 formülü uygulanmalıdır:
ALTER ROLE app_user CONNECTION LIMIT 60;- 1Oturum Zaman Aşımları:
ALTER ROLE app_user SET idle_in_transaction_session_timeout = '1min';
▸Doğrulama
SELECT r.rolname, r.rolconnlimit, count(s.pid) AS active_connections
FROM pg_roles r LEFT JOIN pg_stat_activity s ON r.rolname = s.usename
WHERE r.rolname = 'app_user' GROUP BY r.rolname, r.rolconnlimit;POSTGRESQL Bağlantı Havuzu (Connection Pooling), Ağ Zaman Aşımları ve Soket Yönetimi.
Bu hata yalnızca bir parametre eksikliği değil; veri tutarlılığı, concurrency mimarisi ve kapasite planlaması dersidir.
- İstemci bağlantı havuzu tükenmesi ile veritabanı listener arızasını ayırt edebilmek.
- Ağ güvenlik duvarı ve keepalive parametrelerini production standardına getirebilmek.
Senior Mülakatında Bu Hatadan Ne Sorulur?
Q1POSTGRESQL üzerinde bağlantı kesintilerini izlerken ilk hangi işletim sistemi ve veritabanı metriğine bakılmalıdır?Mid
Veritabanı aktif/idle bağlantı sayıları, OS seviyesinde netstat/ss soket durumları (TIME_WAIT, CLOSE_WAIT) ve listener hata logları kontrol edilmelidir.
Q2Keepalive ayarları bağlantı kopmalarını nasıl engeller?Senior
Güvenlik duvarları veya load balancerlar boşta kalan TCP oturumlarını sessizce düşürür. TCP keepalive periyodik boş paket göndererek oturumun canlı kalmasını sağlar.
Q3Uygulama katmanında bağlantı sızıntısı (connection leak) nasıl tespit edilir?Junior
Veritabanı oturum listesinde uzun süre idle kalan bağlantılar, artan havuz kullanım oranları ve uygulama APM araçlarındaki unclosed connection uyarıları izlenir.
Kıdemli DBA & SRE Kariyer Yol Haritası
Veritabanı güvenilirliği, kriz yönetimi ve mimarlık aşamalarını keşfedin.
POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar
Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.
PostgreSQL Bağlantı Tükenmesi ve too many clients Teşhisi
FATAL: sorry, too many clients already ve remaining connection slots hatalarının üç temel kök nedeni, yetki sınırlarıyla salt okunur pg_stat_activity teşhisi ve kalıcı iki katmanlı havuzlama çözümü.
PostgreSQL password authentication failed Hatası: Neden ve Çözüm
psql password authentication failed hatasının dört nedeni: yanlış şifre, md5/SCRAM uyuşmazlığı, pg_hba.conf sırası ve yanlış cluster. Adım adım teşhis.
PostgreSQL connection refused: 8 Adımda Kesin Teşhis
Connection refused, timeout ve "no pg_hba.conf entry" arasındaki fark; listen_addresses, port, firewall ve Docker port yayınlama kontrolleri.