FATAL: password authentication failed for userpsql "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.
Teshis & Ayırt Etme Protokolü (Disambiguation)
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.
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ü.
PostgreSQL 14.10, 15.6, 16.4, 17.0 (Ubuntu 24.04 LTS, Docker 26.1, Kernel 6.8)
SUPERUSER veya pg_read_all_stats / pg_signal_backend
Geçici session timeout parametrelerini sıfırlama, pgbouncer reload veya pool boyutunu eski haline alma
pg_stat_activity sorgusunda bağlantı sayısının güvenli eşik altına inmesi
PostgreSQL Docs: Connections
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 "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:
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 durumdamd5/scrammetodu 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:
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.
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:
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:
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:
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:
env -u PGPASSWORD psql -h 127.0.0.1 -U postgres -d postgres5. 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:
hostssl uygulama_db uygulama_kullanici 10.0.0.0/8 scram-sha-256trust 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
- •PostgreSQL Güvenlik Hardening CheatSheet
- •PostgreSQL Connection Refused Teşhisi
- •Test edilen sürümler: PostgreSQL 14 / 15 / 16 / 17
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.
- 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
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
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
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.
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 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.
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.