dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/MYSQL/mysql-1071-specified-key-too-long
MySQL
MySQL 8.4 LTS / 9.7 LTSSEVERITY: P2 MEDIUM
7 dk okuma
ERROR 1071 (42000): Specified key was too long; max key length is 3072 bytes

MySQL "Specified key was too long" — 3072 Bayt Sınırı Nereden Geliyor?

3072 bayt indeks sınırının nedeni, utf8mb4 çarpanı, prefix indeks ve bileşik indekslerde toplam boyut hesabı.

İnceleyen:Senior Database Reliability Engineer·29 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

MySQL 8.4 LTS / 9.7 LTS motorunda doğrulanmış operasyonel hata koşulu: 3072 bayt indeks sınırının nedeni, utf8mb4 çarpanı, prefix indeks ve bileşik indekslerde toplam boyut hesabı.

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 9.7.4 LTS & 8.4.13 LTS | Tarihsel: MySQL 8.0.36, 5.7.44

Gerekli Yetki

ALTER TABLE veya INDEX oluşturma yetkisi

Risk & Etki Alanı
MediumPrefix index kullanımı UNIQUE kısıtlarında yalnızca ilk N karakterin tekilliğini garanti eder
Geri Alma (Rollback)

Oluşturulan prefix indeksi kaldırıp sütun boyutunu DYNAMIC satır formatı ile yeniden yapılandırma

Beklenen Çıktı & Doğrulama Kriteri

Prefix index veya SHA-256 generated column ile tablonun 3072 bayt sınırına takılmadan indekslenmesi

Resmî Dokümantasyon Referansı

MySQL 8.4 Reference Manual: InnoDB Limits

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 1071 (42000): Specified key was too long; max key length is 3072 bytes

Bu hata neredeyse her zaman utf8mb4 karakter seti + uzun varchar birleşiminden kaynaklanır. Hesaplama basittir ancak şema tasarımlarında sıklıkla gözden kaçar:

Karakter SetiKarakter Başına Bayt3072 Bayt / Karakter Sınırı
latin11 bayt3.072 karakter
utf8mb3 (utf8)3 bayt1.024 karakter
utf8mb44 bayt768 karakter

Dolayısıyla varchar(768) olan utf8mb4 bir kolon tek başına 3.072 baytlık sınırı doldurur. Bileşik (composite) indekslerde ise tüm kolonların toplam bayt değeri hesaplanır: İki adet varchar(500) utf8mb4 kolon = 1000 × 4 = 4.000 bayt eder ve Error 1071 fırlatılır.


▸Nedeni Doğrulayan Sorgular

sql
SELECT @@innodb_default_row_format; SHOW TABLE STATUS LIKE 'uygulamalar'; -- Row_format sütununu inceleyin SELECT column_name, column_type, character_set_name, character_maximum_length FROM information_schema.columns WHERE table_schema = DATABASE() AND table_name = 'uygulamalar';
NOT
Row_format değeri COMPACT veya REDUNDANT ise sınır 3.072 değil 767 bayttır; hata mesajında da "max key length is 767 bytes" yazar. MySQL 8.0 ve sonrasında varsayılan format DYNAMIC'tir ve eski innodb_large_prefix değişkeni tamamen kaldırılmıştır.

▸Çözüm Yolları

1. Prefix İndeks (En Hızlı Çözüm)

sql
ALTER TABLE uygulamalar ADD INDEX idx_ad (ad(191));

191 karakter, utf8mb4'te 764 bayt tutar ve eski 767 sınırına da sığan klasik standarttır.

DİKKAT / TEHLİKE
Tekillik Riski: Prefix indeks yalnızca ilk N karakteri indeksler. UNIQUE kısıtında kullanırsanız yalnızca ön ek tekilliğini garanti eder; "Ali Veli" ve "Ali Veli2" gibi değerler çakışabilir. Tam tekillik gerekiyorsa 3. yöntemi kullanın.

2. Kolonu Kısaltın ve Satır Formatını Güncelleyin

sql
ALTER TABLE uygulamalar ROW_FORMAT = DYNAMIC; ALTER TABLE uygulamalar MODIFY ad VARCHAR(500) NOT NULL;

3. Tam Tekillik Gerekiyorsa → Üretilmiş Kolon + SHA-256 Hash

sql
ALTER TABLE uygulamalar ADD COLUMN ad_hash BINARY(32) GENERATED ALWAYS AS (UNHEX(SHA2(ad, 256))) STORED, ADD UNIQUE INDEX uk_ad_hash (ad_hash);

Sabit 32 bayt kaplar, 3.072 sınırına hiç yaklaşmaz ve tüm metin üzerinden kusursuz tekillik sağlar.

4. utf8mb3'e Geri Dönmeyin!

utf8mb3'e dönmek sınırı geçici olarak çözer gibi görünür ancak emoji ve 4 baytlık özel karakter desteğini yok eder; bu durum kısa süre sonra MySQL Error 1366: Incorrect string value (H-25) olarak geri döner.


▸Ortak Karşılaştırma: MySQL vs. PostgreSQL İndeks Boyut Sınırları

Mimari KriterMySQL InnoDB (DYNAMIC)PostgreSQL (B-Tree)
Azami Anahtar Boyutu3.072 bayt2.704 bayt (8 KB / 3)
Karakter Sınırı (utf8mb4)768 karakter~676 karakter
Sınır Aşım KoduError 1071 (42000)index row size exceeds maximum
Kardeş RehberBu Rehber (H-22)PostgreSQL Hata Rehberi (H-21)

▸Bunu Bir Daha Yaşamamak İçin

Yeni tablo tasarlarken bileşik indekslerin toplam bayt hacmini önceden hesaplayın: her varchar(n) için n × 4. Toplam 3.000 baytı aşıyorsa tasarımı revize edin. Ayrıca H-25'teki utf8mb4 dönüşümünü planlarken mevcut tüm indekslerin boyutlarını yeniden hesaplayın; utf8mb3 ile sınırda çalışan indeksler dönüşüm sonrası patlayacaktır.

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 1071 (42000): Specified key was too long; max key length is 3072 bytes) 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 1071 "Specified key was too long" Çözümü · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0