Veritabanı ve Performans kod örnekli
MySQL Server Has Gone Away Hatası: Nedenleri ve Kalıcı Çözüm
Hata mesajı sunucunun gittiğini söylüyor, ama çoğu zaman sunucu yerinde duruyor. Asıl soru, bağlantıyı kimin ve neden kestiği.

İçindekiler
- Hata tam olarak neyi söylüyor?
- Neden 1: Bağlantı boşta kaldı, wait_timeout doldu
- Neden 2: Sorgu max_allowed_packet sınırını aştı
- Neden 3: Sunucu yeniden başladı ya da bağlantı öldürüldü
- Neden 4: Aradaki ağ bağlantıyı kesti
- Hangi neden sizinki? Belirtiye göre teşhis
- Kalıcı çözüm: bağlantıyı kullanmadan önce yenileyin
Bu yazıyı dinle
Yapay zekâ sesiyle yaklaşık 2 dakikalık özet
MySQL server has gone away hatası, istemcinin sorgu göndermek istediği bağlantının artık açık olmadığını söyler. En sık nedeni, uzun süre boşta kalan bağlantının wait_timeout dolunca sunucu tarafından kapatılmasıdır; öbür nedenler aşırı büyük sorgu, sunucunun yeniden başlaması ve aradaki ağdır. Kalıcı çözüm de sunucuyu yeniden başlatmak değil, bağlantıyı kullanmadan hemen önce yenilemektir.
PHP'de hata, PDO ile SQLSTATE[HY000]: General error: 2006 MySQL server has gone away satırıyla, CodeIgniter 4'te ise kodu 2006 olan bir DatabaseException olarak gelir. PHP 8.4 ile MySQL 8.0.24 ve sonrasında, boşta kalma yüzünden kopan bağlantı 2006 yerine 4031 koduyla raporlanır. Aşağıdaki nedenler XAMPP 8.2 ile gelen MariaDB 10.4 ve PHP 8.2 üzerinde tek tek yeniden üretilerek yazıldı.

Hata tam olarak neyi söylüyor?
2006 kodu, istemcinin sorguyu sunucuya iletemediğini anlatır: bağlantı, sorgudan önce kapanmıştır. Yakın akrabası 2013, yani "Lost connection to MySQL server during query", sorgu gönderildikten sonra yanıt beklenirken bağlantının koptuğu durumdur.
Dört nedenin her biri farklı bir iz bırakır: paket boyutu hatadan hemen önce bir 1153 satırı, boşta kalma iş aralarındaki uzun bir bekleme, yeniden başlama kısa bir Uptime, ağ ise yalnız uzak makinede görülen bir hata. Aşağıdaki bölümler bu izleri sırayla anlatıyor.
Neden 1: Bağlantı boşta kaldı, wait_timeout doldu
Sunucu, belirli bir süre hiç sorgu gelmeyen bağlantıyı kendisi kapatır. Bu süre wait_timeout değişkenindedir; MySQL ve MariaDB'de varsayılanı 28800 saniye, yani 8 saattir. Paylaşımlı barındırmalarda çok daha düşük ayarlanmış olabilir.
Web isteği bu sınıra takılmaz, çünkü birkaç saniye sürer ve her seferinde yeni bağlantı açar. Takılanlar cron işleri, kuyruk işçileri ve saatlerce açık kalan komut satırı betikleridir. Durumu yerelde birkaç saniyede üretebilirsiniz:
$pdo = new PDO('mysql:host=127.0.0.1;dbname=deneme;charset=utf8mb4', 'root', '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$pdo->exec('SET SESSION wait_timeout = 2'); // yalnız bu bağlantı için
sleep(4);
$pdo->query('SELECT 1'); // 2006 MySQL server has gone away (PHP 8.4 + MySQL 8.0.24+: 4031)Dikkat: SET SESSION yalnız o bağlantıyı etkiler; sunucunun ayarına dokunmaz.
Neden 2: Sorgu max_allowed_packet sınırını aştı
Tek seferde gönderilen sorgu, sunucunun kabul ettiği en büyük paketten büyükse sunucu bağlantıyı kapatır. Sınır max_allowed_packet değişkenindedir; MySQL 8.4 belgelerinde varsayılanı 64 MB olarak geçer, MariaDB'de ise farklıdır. Binlerce satırlık tek bir INSERT, base64'e çevrilmiş görseller ya da büyük bir JSON alanı bu sınıra tipik olarak takılan işlerdir.
Bu nedenin ayırt edici bir izi var: sınırı aşan sorgu önce SQLSTATE[08S01]: Communication link failure: 1153 Got a packet bigger than 'max_allowed_packet' bytes hatasını verir, aynı bağlantıdaki bir sonraki sorgu ise 2006 ile düşer. Günlükte yalnız son satıra bakan, gerçek nedeni kaçırır. Bu iz her zaman görünmez; MySQL belgelerine göre bazı istemciler doğrudan bağlantı kopması hatası alır. 1153 yoksa gönderilen sorgunun boyutunu da ölçün.
Çözüm, sınırı yükseltmekten önce yazmayı parçalara bölmektir; toplu yükleme deseni aynı düşünceyi okuma tarafı için anlatır. Sınırı gerçekten yükseltmeniz gerekiyorsa önce kendi değerinizi SHOW VARIABLES LIKE 'max_allowed_packet' ile okuyun. XAMPP'te ayar C:\xampp\mysql\bin\my.ini dosyasının [mysqld] bölümündedir; değişiklikten sonra MySQL'i yeniden başlatın.
Aynı dosyada [mysqldump] bölümünün ayrı bir max_allowed_packet satırı vardır; yedek alma aracı kendi sınırını oradan okur. Büyük tabloların yedeğinde hata alıyorsanız sunucudaki [mysqld] değeriyle birlikte bakılacak yer orasıdır; MySQL belgeleri sınırın hem istemcide hem sunucuda yükseltilmesi gerektiğini söyler. Tek seferlik bir yedek için istemci tarafında mysqldump --max-allowed-packet=64M de kullanılabilir. Yedeği geri yüklemeyi ayrıca deneyin: geri dönüşü denenmemiş yedek kâğıt üstünde kalır.
Neden 3: Sunucu yeniden başladı ya da bağlantı öldürüldü
Sunucu yeniden başladığında açık olan bütün bağlantılar kopar. Bir yönetici ya da izleme aracı KILL komutuyla tek bir bağlantıyı sonlandırdığında da o bağlantının bir sonraki sorgusu 2006 verir. Linux sunucularda bellek tükendiğinde çekirdeğin MySQL sürecini sonlandırması da aynı sonucu doğurur.
İzini sürmek için önce sunucunun ne zamandır ayakta olduğuna bakın:
SHOW GLOBAL STATUS LIKE 'Uptime'; -- saniye cinsinden çalışma süresi
SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'max_allowed_packet';Uptime değeri, hatanın görüldüğü andan bu yana geçen süreden kısaysa sunucu yeniden başlamıştır. Linux'ta journalctl -k | grep -i "out of memory" komutu, çekirdeğin bellek yüzünden bir süreci sonlandırıp sonlandırmadığını gösterir.
Neden 4: Aradaki ağ bağlantıyı kesti
Uygulama ile veritabanı ayrı makinelerdeyse, aradaki güvenlik duvarı, NAT ya da yük dengeleyici uzun süre boşta kalan TCP bağlantısını kendi zaman aşımıyla kesebilir. Örneğin Azure Load Balancer boşta kalan bağlantıyı varsayılan olarak 4 dakika sonra keser. Bu durumda sunucunun wait_timeout değeri yüksek olsa bile bağlantı ölür, çünkü kesen sunucu değildir.
İpucu şudur: aynı iş veritabanıyla aynı makinede çalıştırıldığında sorunsuz, ayrı makineden çalıştırıldığında hatalıysa sorun ağdadır.
Hangi neden sizinki? Belirtiye göre teşhis
Dört nedeni ayırmanın en hızlı yolu, hatanın ne zaman ve nerede görüldüğüne bakmaktır:
| Belirti | Muhtemel neden | Kontrol |
|---|---|---|
| Yalnız cron ya da kuyruk işinde, uzun beklemeden sonra | wait_timeout | SHOW VARIABLES LIKE 'wait_timeout' |
| Hatadan hemen önce 1153 var | max_allowed_packet | Sorgunun boyutu; 1153 yoksa da ölçün |
| Bütün bağlantılar aynı anda koptu | Sunucu yeniden başladı | Uptime, sistem günlüğü |
| Yalnız ayrı makineden bağlanınca | Ağ zaman aşımı | Aynı işi sunucu üzerinde çalıştırın |
MySQL belgeleri ilk satırı en yaygın neden olarak anar; teşhise oradan başlamak çoğu zaman yeter.
Kalıcı çözüm: bağlantıyı kullanmadan önce yenileyin
Kalıcı çözüm wait_timeout değerini yükseltmek değil, uzun bir beklemeden sonra bağlantıyı kullanmadan önce tazelemektir. CodeIgniter 4'te bunun için reconnect() yöntemi var; bağlantıyı kapatıp yeniden açar. Kontrol işin başında değil, veritabanına dokunmadan hemen önce yapılmalıdır:
use CodeIgniter\Database\BaseConnection;
/** Bağlantı $esik saniyeden uzun boşta kaldıysa kullanmadan önce yeniler. */
function tazeBaglanti(BaseConnection $db, int &$sonKullanim, int $esik = 180): void
{
if (time() - $sonKullanim > $esik) {
$db->reconnect();
}
$sonKullanim = time();
}
$db = db_connect();
$sonKullanim = time();
foreach ($dosyalar as $dosya) {
$ozet = uzunSurenIslem($dosya); // dakikalar sürebilir, veritabanına dokunmaz
tazeBaglanti($db, $sonKullanim);
$db->table('islenen_dosyalar')->insert(['dosya' => $dosya, 'ozet' => $ozet]);
}Eşiği hem sunucudaki wait_timeout değerinin hem de aradaki ağ cihazının boşta kalma süresinin altında seçin. wait_timeout 28800 ise 180 saniye bol bir paydır; 60 saniyeyse eşik 30 saniye olmalıdır; araya 4 dakikada kesen bir yük dengeleyici giriyorsa eşik onun da altında kalmalıdır.
Okuma sorgularında hatayı yakalayıp bir kez yeniden denemek de mümkündür. CodeIgniter 4'te DBDebug açıkken (varsayılan) istisna fırlatılır; hata ayrıntısı sızmasın diye kapatıldıysa query() sessizce false döner. Aşağıdaki kalıp iki durumu da kapsar:
use CodeIgniter\Database\Exceptions\DatabaseException;
try {
$sonuc = $db->query($sql, $degerler); // DBDebug kapalıysa hata false döner
} catch (DatabaseException $e) { // DBDebug açıksa istisna gelir
$sonuc = false;
}
if ($sonuc === false && in_array($db->error()['code'] ?? 0, [2006, 4031], true)) {
$db->reconnect(); // bağlantı ölmüştü: okuma sorgusunu bir kez daha dene
$sonuc = $db->query($sql, $degerler);
}Bu kalıbı işlem (transaction) içinde ve yazma sorgularında kullanmayın. Yeniden bağlanınca açık işlem sessizce kaybolur; bağlantı yanıt beklenirken koptuysa (2013) kayıt sunucuda çoktan yazılmış olabilir ve ikinci deneme aynı siparişi iki kez oluşturur. Saatlerce çalışan işçileri systemd servisi olarak çalıştırırsanız Restart=on-failure ayarı, bağlantı hatasıyla düşen işçiyi temiz bir bağlantıyla yeniden başlatır.
MySQL server has gone away size nedeni söylemez; nedeni, hatanın çevresinde bıraktığı iz söyler. Önce hatadan hemen önceki satıra bakın: 1153 varsa sorun paket boyutudur. Ardından wait_timeout ve Uptime değerlerini okuyun, işlerinizin ne kadar boşta beklediğini ölçün. Büyük yazmaları parçalara bölün, bağlantıyı veritabanına dokunmadan hemen önce yenileyin, 4031 kodunu da yakalayın ve yeniden denemeyi yalnız işlem dışındaki okuma sorgularında yapın.
Konunun derinlemesine anlatımı için: MySQL 8.4 Reference Manual — MySQL server has gone away.
Sık sorulan sorular
Gone away ile "Lost connection to MySQL server during query" aynı hata mı?
Hayır. 2006, istemci sorguyu sunucuya gönderemediğinde görülür. 2013 ise sorgu gönderildikten sonra, yanıt beklenirken bağlantı koptuğunda gelir. 2013'te yazma sunucuda tamamlanmış olabilir; bu yüzden yazma sorgusu körlemesine tekrarlanmaz.
wait_timeout değerini artırmak hatayı çözer mi?
Yalnız belirtiyi erteler. Boşta bekleyen bağlantılar daha uzun yaşar ve max_connections sınırına daha çabuk ulaşılır. Uzun süren işlerde bağlantıyı kullanmadan önce yenilemek, sorunu kaynağında çözen yöntemdir.
XAMPP'te max_allowed_packet ayarı nerede?
C:\xampp\mysql\bin\my.ini dosyasında. [mysqld] bölümündeki satır sunucuyu, [mysqldump] bölümündeki satır yedek alma aracını etkiler. Değişiklikten sonra MySQL'i XAMPP Kontrol Paneli'nden durdurup yeniden başlatın.
"General error: 4031" hatası gone away ile aynı şey mi?
Aynı durumun yeni kodudur. PHP 8.4, MySQL 8.0.24 ve sonrasına bağlanırken boşta kalma yüzünden kopan bağlantıyı 2006 yerine 4031 ile raporlar. Hatayı yakalayan kodunuz yalnız 2006'ya bakıyorsa 4031'i de ekleyin.
Yazan
Çılgın Yazılım
Ben Evren Çılgın; yazılım geliştirme, web teknolojileri ve sistem tasarımı alanlarında uzmanlaşmış bir geliştiriciyim. Uzun yıllardır hem frontend hem de backend tarafında üretken, ölçeklenebilir ve kullanıcı dostu çözümler üretiyorum.
Bu konuda bir projeniz mi var?
İhtiyacınızı birkaç cümleyle anlatın; uygun yaklaşımı birlikte belirleyelim.
İlgili yazılar
Yorumlar
Henüz yorum yok. Sorunuzu ya da deneyiminizi ilk siz yazın.
Yorum yazın
Yorumunuz onaylandıktan sonra yayınlanır. Ekibimiz gerekirse konuyla ilgili bir yanıt da paylaşır.