dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-connection-refused
PostgreSQL
PG 14 - 17SEVERITY: P2 MEDIUM
4 dk okuma
could not connect to server: Connection refused

PostgreSQL "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.

İnceleyen:Kıdemli Veritabanı Mimarı & SRE (dataiotech Labs)·30 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PG 14 - 17 ortamında istemci ile veritabanı arasındaki bağlantı, soket veya ağ zaman aşımı durumunu ifade eder.

Ne Zaman Bu Hata DEĞİLDİR?

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ü.

Laboratuvarda Doğrulandı
Test Edilen Sürümler

PostgreSQL 14.10, 15.6, 16.4, 17.0 (Ubuntu 24.04 LTS / Docker 26.1)

Gerekli Yetki

İşletim sistemi / Host seviyesinde sudo / root erişimi (systemctl, netstat/ss, docker ps kontrolleri için)

Risk & Etki Alanı
LowSalt okunur ağ ve servis kontrolleri risk içermez; postgresql.conf listen_addresses veya firewall değişiklikleri servis yeniden başlatması gerektirebilir
Geri Alma (Rollback)

Değiştirilen postgresql.conf veya iptables/ufw kurallarını önceki yedeğe geri alma ve servisi reload etme

Beklenen Çıktı & Doğrulama Kriteri

PostgreSQL 5432 portunun dinlemede olması (LISTEN), systemctl status active (running) ve psql ile yerel TCP bağlantısının başarılı olması

İlk 60 Saniye Teşhis Protokolü (Read-Only Safety Rule):

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

plaintext
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.

MesajKatmanAnlamı
Connection refusedAğ/süreçPortta dinleyen yok ya da bağlantı aktif reddedildi
Connection timed outAğPaketler düşüyor: firewall, security group, yanlış IP
no pg_hba.conf entryKimlik doğrulamaSunucuya ulaşıldı, kural eşleşmedi

▸Adım adım teşhis

1. Sunucuya ağ erişiminiz var mı?

bash
pg_isready -h 10.0.4.12 -p 5432

2. Süreç ayakta mı ve hangi arayüzü dinliyor?

bash
sudo systemctl status postgresql sudo ss -ltnp | grep 5432

ss çı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.

sql
SHOW listen_addresses; SHOW port;

Varsayılan localhost'tur. Değiştirmek için:

sql
ALTER SYSTEM SET listen_addresses = '*';

Bu ayar yeniden başlatma gerektirir:

bash
sudo systemctl restart postgresql

4. Firewall ve Security Group kontrolleri.

bash
sudo ufw status sudo iptables -L -n | grep 5432

5. Docker port haritalama kontrolü. Konteyner içinde PostgreSQL çalışsa bile, -p 5432:5432 verilmediyse ana makineden ulaşılamaz:

bash
docker ps --format "table {{.Names}}\t{{.Ports}}"

6. Disk dolması kaynaklı çökme kontrolü.

bash
sudo tail -50 /var/log/postgresql/postgresql-17-main.log df -h

▸İlgili Mühendislik Rehberleri ve İç Linkler

YENİ KONSEPTMÜHENDİSLİK BECERİSİ
Senior Mülakat Hazırlığı

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.

Öğrenme Hedefleri (Ölçülebilir Çıktılar):
  • İ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
Senior Mühendis / Mimar Yanıtı:

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
Senior Mühendis / Mimar Yanıtı:

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
Senior Mühendis / Mimar Yanıtı:

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.

Yol Haritasını İncele

POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar

Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.

Tümünü Gör
dbaguide.com · PostgreSQL connection refused: 8 Adımda Kesin Teşhis · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0