dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-password-authentication-failed
PostgreSQL
PG 14 - 17SEVERITY: P2 MEDIUM
4 dk okuma
FATAL: password authentication failed for user

psql "password authentication failed for user" — Şifre mi Yanlış, pg_hba.conf mu?

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.

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

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PG 14 - 17 motorunda doğrulanmış operasyonel hata koşulu: 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.

Ne Zaman Bu Hata DEĞİLDİR?

Farklı bir veritabanı motorunun veya alakasız alt sistemin hatası değildir; doğrudan ilgili motorun hata kataloğuna 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, Kernel 6.8)

Gerekli Yetki

SUPERUSER veya pg_read_all_stats / pg_signal_backend

Risk & Etki Alanı
Mediumİşlemdeki oturumları pg_terminate_backend ile sonlandırmak uygulama katmanında rollback yaratır
Geri Alma (Rollback)

Geçici session timeout parametrelerini sıfırlama, pgbouncer reload veya pool boyutunu eski haline alma

Beklenen Çıktı & Doğrulama Kriteri

pg_stat_activity sorgusunda bağlantı sayısının güvenli eşik altına inmesi

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Connections

Belgeyi Yeni Sekmede Aç
İ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 "127.0.0.1", port 5432 failed: FATAL: password authentication failed for user "postgres"

Bu mesaj son derece yanıltıcıdır: şifrenin yanlış olduğu anlamına gelmez. PostgreSQL, kimlik doğrulama katmanında neyin başarısız olduğunu kasten açıklamaz (kullanıcı numaralandırmasını engellemek için). Dört farklı neden aynı metni üretir.


▸Nedeni ayırt eden sorgu

Şifrenin nasıl saklandığına bakın — bu tek kontrol, vakaların yarısını çözer:

sql
SELECT rolname, left(rolpassword, 14) AS saklama_bicimi FROM pg_authid WHERE rolname IN ('postgres', 'uygulama_kullanici');
  • •SCRAM-SHA-256$... → SCRAM ile saklanmış
  • •md5... → eski MD5 formatı
  • •NULL → kullanıcının hiç şifresi yok (bu durumda md5/scram metodu her zaman başarısız olur)

Ardından hangi satırın eşleştiğini kontrol edin. pg_hba.conf'ta ilk eşleşen satır kazanır, sonrakiler okunmaz:

sql
SELECT type, database, user_name, address, auth_method FROM pg_hba_file_rules ORDER BY rule_number;

▸Adım adım çözüm

1. Şifrelenme yöntemini kontrol edin.

sql
SHOW password_encryption;

PostgreSQL 14'ten itibaren varsayılan scram-sha-256. Eğer pg_hba.conf scram-sha-256 istiyor ama kullanıcının şifresi md5 formatında saklanmışsa, doğrulama her zaman başarısız olur — şifre doğru olsa bile.

2. Şifreyi yeniden yazın (doğru yöntemle). Süper kullanıcı olarak:

sql
SET password_encryption = 'scram-sha-256'; ALTER USER postgres WITH PASSWORD 'yeni-guclu-sifre';

ALTER USER sonrası pg_reload_conf() gerekmez; şifre anında geçerlidir. pg_hba.conf değişikliği için gerekir:

sql
SELECT pg_reload_conf();

3. Bağlanan istemcinin gerçekten hangi sunucuya gittiğini doğrulayın. Vakaların küçümsenmeyecek bir kısmı şudur: makinede iki PostgreSQL kurulu (ör. 14 ve 16), psql birine, uygulama diğerine bağlanıyor. Kontrol:

bash
pg_isready -h 127.0.0.1 -p 5432 psql -h 127.0.0.1 -p 5432 -U postgres -c "SELECT version(), inet_server_port();"

4. İstemci tarafındaki kalıntıları temizleyin. ~/.pgpass, PGPASSWORD ortam değişkeni veya eski bir ~/.pg_service.conf girdisi, elinizle yazdığınız şifreyi sessizce eziyor olabilir. Test ederken bunları geçici olarak devre dışı bırakın:

bash
env -u PGPASSWORD psql -h 127.0.0.1 -U postgres -d postgres

5. Uzak bağlantıda `pg_hba.conf` satırını ekleyin. Varsayılan kurulumda yalnızca 127.0.0.1/32 ve ::1/128 için satır vardır. Uzak istemci için eklenmesi gereken satır:

plaintext
hostssl uygulama_db uygulama_kullanici 10.0.0.0/8 scram-sha-256
DİKKAT / TEHLİKE
trust yazarak "sorunu çözmek", bu hatanın en tehlikeli yanlış cevabıdır: kimlik doğrulamayı tamamen kapatır ve genellikle üretimde unutulur.

▸Bunu bir daha yaşamamak için

pg_hba.conf'u bir yapılandırma yönetimi aracıyla (Ansible, Terraform) yönetin ve her değişiklikte pg_hba_file_rules görünümünü okuyup etkin kuralları doğrulayın. Dosyada doğru satırın olması, onun ilk eşleşen satır olduğu anlamına gelmez.


▸İlgili Mühendislik Rehberleri ve İç Linkler

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

POSTGRESQL Teşhis Standartları, Operasyonel Güvenilirlik ve Mülakat Hazırlığı.

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):
  • Hatanın belirtisini, nedenini ve güvenli çözüm adımlarını açıklayabilmek.
  • Kök nedeni kalıcı olarak ortadan kaldıran mühendislik kararlarını uygulamak.

Senior Mülakatında Bu Hatadan Ne Sorulur?

Q1Bu hata (FATAL: password authentication failed for user) production ortamında görüldüğünde ilk 60 saniyede hangi kontrol yapılmalıdır?
Mid
Senior Mühendis / Mimar Yanıtı:

Doğrudan sunucuyu yeniden başlatmadan önce aktif oturumlar, kilit durumları ve hata günlüğü incelenerek gerçek senaryo ayırt edilmelidir.

Q2Bu hatanın tekrarlanmaması için monitoring ve alarm sistemine hangi metrik eklenmelidir?
Senior
Senior Mühendis / Mimar Yanıtı:

Hata eşiğini önceden haber veren bağlantı, bellek, disk veya kilit kuyruğu metrikleri tanımlanarak eşik aşımlarında P1 alarm üretilmelidir.

Q3Uygulama katmanında bu hataya karşı savunmacı kodlama (defensive programming) nasıl uygulanır?
Junior
Senior Mühendis / Mimar Yanıtı:

Transaction retry döngüleri, zaman aşımı sınırları, bağlantı havuzu boyutlandırması ve doğru hata loglaması uygulanmalıdır.

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 password authentication failed Hatası: Neden ve Çözüm · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0