dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/MYSQL/mysql-1062-duplicate-entry-unique-key
MySQL
MySQL 8.0 - 8.4SEVERITY: P2 MEDIUM
3 dk okuma
ERROR 1062 (23000): Duplicate entry 'test@example.com' for key 'users.email_UNIQUE'

MySQL Benzersiz İndeks İhlali: Eşzamanlılık Yarışı (Race Condition), ETL Duplikasyonu ve Çözüm Desenleri

Uygulama katmanı race condition ve mükerrer batch kayıtları sonucu oluşan 1062 hatasının tespiti, INSERT IGNORE ve ON DUPLICATE KEY UPDATE desenleri.

İnceleyen:Kıdemli Veritabanı Mimarı & SRE (dataiotech Labs)·2 Kasım 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

MySQL 8.0 - 8.4 motorunda doğrulanmış operasyonel hata koşulu: Uygulama katmanı race condition ve mükerrer batch kayıtları sonucu oluşan 1062 hatasının tespiti, INSERT IGNORE ve ON DUPLICATE KEY UPDATE desenleri.

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

MySQL 8.0.36, 8.4.1 LTS

Gerekli Yetki

SELECT, INSERT, UPDATE on target table

Risk & Etki Alanı
MediumON DUPLICATE KEY UPDATE sırasında AUTO_INCREMENT değerleri hızla tüketilebilir ve INT sınırına dayanabilir
Geri Alma (Rollback)

Hatalı eklenen mükerrer kaydı silme veya eski haline getirme

Beklenen Çıktı & Doğrulama Kriteri

Mükerrer satırın tespiti ve idempotent INSERT komutunun başarıyla 1 row affected dönmesi

Resmî Dokümantasyon Referansı

MySQL Docs: INSERT ... ON DUPLICATE KEY UPDATE

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

Kullanıcı kaydı veya veri yükleme sırasında işlem kesilir ve şu hata döner:

plaintext
ERROR 1062 (23000): Duplicate entry 'test@example.com' for key 'users.email_UNIQUE'

▸Sahada Ne Görürsün?

Kullanıcı formu kaydederken çift tıkladığında veya iki pod aynı anda aynı kaydı oluşturmaya çalıştığında biri başarılı olurken diğeri HTTP 500 döner.


▸Kök Neden Matrisi

OlasılıkKök NedenAçıklama
%60Eşzamanlı İstek Yarışı (Race Condition)Uygulama önce SELECT yapıp kayıt olmadığını görüp INSERT eder; iki istek araya girdiğinde ikinci INSERT patlar.
%30ETL / Batch TekrarıTekrar çalışan veri aktarım scripti mevcut kayıtları ezmek yerine doğrudan eklemeye çalışır.
%10Büyük/Küçük Harf (Collation) Duyarsızlığıutf8mb4_0900_ai_ci collation altında Test@example.com ile test@example.com aynı kabul edilir.

▸ACİL RUNBOOK (0-5dk)

sql
-- 1. Çakışan kaydı bul SELECT id, email, created_at FROM users WHERE email = 'test@example.com'; -- 2. Tablodaki tüm mükerrer kayıtları listele SELECT email, count(*) AS c FROM users GROUP BY email HAVING c > 1; -- 3. Acil idempotent düzeltme: INSERT IGNORE veya ON DUPLICATE KEY UPDATE INSERT INTO users (email, full_name, updated_at) VALUES ('test@example.com', 'Test User', NOW()) ON DUPLICATE KEY UPDATE full_name = VALUES(full_name), updated_at = NOW();

▸KALICI BLUEPRINT

  1. 1Check-Then-Act Antipattern'ını Bırakın: Uygulamada SELECT COUNT(*) yapıp ardından INSERT etmek yerine doğrudan veritabanının unique constraint'ine güvenin ve ON DUPLICATE KEY UPDATE kullanın.
  2. 2BIGINT Kullanımı: Sık duplicate denemelerinde AUTO_INCREMENT id hızla büyüyebileceği için birincil anahtarlar BIGINT UNSIGNED yapılmalıdır.

▸Doğrulama

sql
SHOW INDEX FROM users WHERE Key_name = 'email_UNIQUE';
YENİ KONSEPTMÜHENDİSLİK BECERİSİ
Senior Mülakat Hazırlığı

MYSQL 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 1062 (23000): Duplicate entry 'test@example.com' for key 'users.email_UNIQUE') 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

MYSQL 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 · MySQL ERROR 1062 (23000): Duplicate entry for key Teşhisi · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0