dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-deadlock-detected
PostgreSQL
PostgreSQL 14–18SEVERITY: P1 HIGH
8 dk okuma
ERROR: deadlock detected

PostgreSQL "deadlock detected" — Hangi İki İşlem Birbirini Kilitledi?

PostgreSQL deadlock hatasında bloklayan oturumları pg_blocking_pids ile bulma, log_lock_waits ayarı ve erişim sırası düzeltmesi.

İnceleyen:Principal SRE & Lead Database Architect·29 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PostgreSQL 14–18 motorunda doğrulanmış operasyonel hata koşulu: PostgreSQL deadlock hatasında bloklayan oturumları pg_blocking_pids ile bulma, log_lock_waits ayarı ve erişim sırası düzeltmesi.

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

Resmî Belgelerle İncelendi
Test Edilen Sürümler

PostgreSQL 18.6 & 17.11 | Tarihsel: PostgreSQL 14.10, 15.6, 16.4

Gerekli Yetki

pg_stat_activity ve pg_blocking_pids() sorgulama yetkisi

Risk & Etki Alanı
HighDeadlock tespit edildiğinde PostgreSQL kurban işlemi (victim transaction) anında abort eder
Geri Alma (Rollback)

Uygulama katmanında sınırlı ve jitter destekli otomatik retry mekanizması işletme

Beklenen Çıktı & Doğrulama Kriteri

Deterministik ORDER BY kilit sıralaması ve log_lock_waits ile kilit döngülerinin engellenmesi

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Explicit Locking & Deadlocks

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
ERROR: deadlock detected DETAIL: Process 4821 waits for ShareLock on transaction 9102; blocked by process 9102. Process 9102 waits for ShareLock on transaction 4821; blocked by process 4821. HINT: See server log for query details.

PostgreSQL döngüsel kilitlenmeyi (Wait-For Graph) tespit ettiğinde işlemlerden birini kurban seçerek anında iptal eder (SQLSTATE 40P01). Bu kontrol deadlock_timeout (varsayılan 1 saniye) süresi dolmadan tetiklenmez; yani 1 saniyeden kısa süren kilit beklemeleri deadlock kontrolüne takılmaz.


▸Blokaj Zincirini ve Kök Oturumu Bulma

PostgreSQL'in bu iş için yerleşik fonksiyonu vardır:

sql
SELECT pid, pg_blocking_pids(pid) AS bloklayanlar, state, now() - query_start AS suredir, left(query, 100) AS sorgu FROM pg_stat_activity WHERE cardinality(pg_blocking_pids(pid)) > 0 ORDER BY suredir DESC;

bloklayanlar dizisinde yer alan ve kendi bloklayanlar hücresi boş olan oturum kilit ağacının tepesindeki kök nedendir.

Kilit beklemelerini kalıcı kayıt altına almak için:

sql
ALTER SYSTEM SET log_lock_waits = on; SELECT pg_reload_conf();

Artık deadlock_timeout süresini aşan her kilit beklemesi deadlock oluşmasa dahi sunucu günlüğüne kaydedilir.


▸En Sık Üç Kök Neden

1. Ters Tablo Erişim Sırası

  • •İşlem A: hesap tablosunu kilitler → hareket tablosunu bekler.
  • •İşlem B: hareket tablosunu kilitler → hesap tablosunu bekler.

Çözüm: Tüm uygulama kodlarında tabloların her zaman alfabetik veya hiyerarşik aynı sırayla kilitlenmesini sağlayın.

2. Yabancı Anahtar (Foreign Key) Kontrolleri

PostgreSQL'de FK kontrolleri ebeveyn satır üzerinde FOR KEY SHARE kilidi alır. İki eşzamanlı işlem farklı tablolara yazarken birbirlerinin ebeveyn satırlarını güncelliyorsa kilitlenme veritabanı motoru katmanında tetiklenir.

3. Toplu Güncellemelerde Rastgele Satır Sıralaması

sql
-- YANLIŞ: IN listesi deterministik sırada kilitlenmez UPDATE hesap SET bakiye = bakiye - 10 WHERE id IN (42, 17, 99); -- DOĞRU: Sıralı ve deterministik kilit edinimi UPDATE hesap SET bakiye = bakiye - 10 WHERE id IN (SELECT unnest(ARRAY[42, 17, 99]) ORDER BY 1);

▸Uygulama Tarafında Yeniden Deneme (Retry) ve Adli İnceleme

Deadlock kurbanı işlem veritabanı motoru tarafından anında abort edilir (SQLSTATE 40P01). Ancak bu hata karşısında koşulsuz ya da anlık yeniden deneme yapmak, döngüdeki diğer oturumla birlikte yeni bir *yeniden deneme fırtınası* (retry storm) yaratır:

  • •Kurban Önceden Sabit Değildir: PostgreSQL döngüdeki işlemlerden maliyeti en düşük veya kilit kuyruğunda uygun gördüğü herhangi bir oturumu kurban seçebilir (L2 laboratuvarımızda Session A kurban seçilirken Session B hayatta kalmıştır). Bu nedenle döngüye giren her işlem 40P01 alabilecek şekilde kodlanmalıdır.
  • •İşlem Semantiği ve Idempotency: Yeniden deneme kararı yalnızca hata koduna bakılarak evrensel bir kural olarak verilemez. İşlemin yan etkileri (harici API çağrıları, ödeme provizyonları, kuyruk mesajları) varsa, transaction mutlaka idempotent olmalıdır.
  • •Rastgele Gecikmeli Üstel Geri Çekilme (Full Jitter): Anlık yeniden deneme yerine wait = random(0, min(max_backoff, base * 2^attempt)) formülüyle geri çekilme uygulanmalıdır.
  • •Geçmiş Olay Kanıtı: Deadlock kurbanı abort edildiğinde canlı kilit grafı anında normale döner. Bu nedenle gerçekleşmiş bir deadlock'un adli incelemesi yalnızca log_lock_waits = on ve sunucu loglarındaki kilit grafı üzerinden yapılabilir.

Detaylı laboratuvar kanıtları ve derin mimari için: PostgreSQL Kilitlerini Okumak: Blocking, Deadlock ve Uzun Transaction'lar ve Deadlock Olay Sonrası İnceleme Runbook'u.

UYARI
deadlock_timeout değerini yükseltmeyin; yükseltmek tespiti geciktirir ve tüm oturumların kuyrukta beklemesine yol açar.
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 (ERROR: deadlock detected) 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 "deadlock detected" Hatası: Grafiği Okuma ve Önleme · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0