could not connect to server: Connection refusedPostgreSQL "Connection refused" — Sunucu mu Kapalı, Ağ mı Engelli?
Connection refused, timeout ve "no pg_hba.conf entry" arasındaki fark; listen_addresses, port, firewall ve Docker port yayınlama kontrolleri.
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.0 (Ubuntu 24.04 LTS / Docker 26.1)
İşletim sistemi / Host seviyesinde sudo / root erişimi (systemctl, netstat/ss, docker ps kontrolleri için)
Değiştirilen postgresql.conf veya iptables/ufw kurallarını önceki yedeğe geri alma ve servisi reload etme
PostgreSQL 5432 portunun dinlemede olması (LISTEN), systemctl status active (running) ve psql ile yerel TCP bağlantısının başarılı olması
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
psql: error: connection to server at "10.0.4.12", port 5432 failed:
could not connect to server: Connection refused
Is the server running on that host and accepting TCP/IP connections?Bu hata mesajı nettir: hedef portta dinleyen hiçbir süreç yok. Yani sorun kimlik doğrulama değil, ağ ya da süreç seviyesindedir.
| Mesaj | Katman | Anlamı |
|---|---|---|
Connection refused | Ağ/süreç | Portta dinleyen yok ya da bağlantı aktif reddedildi |
Connection timed out | Ağ | Paketler düşüyor: firewall, security group, yanlış IP |
no pg_hba.conf entry | Kimlik doğrulama | Sunucuya ulaşıldı, kural eşleşmedi |
▸Adım adım teşhis
1. Sunucuya ağ erişiminiz var mı?
pg_isready -h 10.0.4.12 -p 54322. Süreç ayakta mı ve hangi arayüzü dinliyor?
sudo systemctl status postgresql
sudo ss -ltnp | grep 5432ss çıktısında 127.0.0.1:5432 görüp 0.0.0.0:5432 görmüyorsanız, sunucu yalnızca yerel bağlantı kabul ediyor demektir.
3. Dinleme adresini kontrol edin.
SHOW listen_addresses;
SHOW port;Varsayılan localhost'tur. Değiştirmek için:
ALTER SYSTEM SET listen_addresses = '*';Bu ayar yeniden başlatma gerektirir:
sudo systemctl restart postgresql4. Firewall ve Security Group kontrolleri.
sudo ufw status
sudo iptables -L -n | grep 54325. Docker port haritalama kontrolü. Konteyner içinde PostgreSQL çalışsa bile, -p 5432:5432 verilmediyse ana makineden ulaşılamaz:
docker ps --format "table {{.Names}}\t{{.Ports}}"6. Disk dolması kaynaklı çökme kontrolü.
sudo tail -50 /var/log/postgresql/postgresql-17-main.log
df -h▸İlgili Mühendislik Rehberleri ve İç Linkler
- •PostgreSQL Password Authentication Failed Rehberi
- •PostgreSQL İlk Restore Tatbikatı Runbook'u
- •Test edilen sürümler: PostgreSQL 14 / 15 / 16 / 17
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 duplicate key Hatası: Sequence Kayması Düzeltme
Restore veya toplu içe aktarma sonrası "duplicate key value violates unique constraint" hatasının nedeni, tek komutla düzeltme ve tüm sequence'ları tarayan DO bloğu.