---
title: "MySQL Server Has Gone Away Hatası: Nedenleri ve Kalıcı Çözüm"
url: "https://cilginyazilim.com/blog/mysql-server-has-gone-away-hatasi"
description: "MySQL server has gone away (2006) hatasının dört nedeni, her birini ayıran teşhis komutları ve PHP, PDO ile CodeIgniter 4 için kalıcı çözüm."
published: "2026-11-20T10:00:00+03:00"
modified: "2026-11-20T10:00:04+03:00"
author: "Çılgın Yazılım"
category: "Veritabanı ve Performans"
tags: ["php", "codeigniter", "mysql", "yedekleme", "hata ayıklama", "mariadb"]
site: "Çılgın Yazılım"
language: "tr"
---

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

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

![MySQL server has gone away hatasında nedenleri ayırt etmek için kontrol sırası](https://cilginyazilim.com/uploads/blog/2026/09/mysql-server-has-gone-away-hatasi-ozet.png)
*Gone away bir neden değil, bağlantının öldüğünü haber veren bir sonuçtur.*

## 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:

```php
$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](https://cilginyazilim.com/blog/toplu-yukleme-batch-loading-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](https://cilginyazilim.com/blog/yedekleme-var-ama-geri-donus-denenmemis) 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:

```sql
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:

```php
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:

```php
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](https://cilginyazilim.com/blog/systemd-servis-yazma-rehberi) 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](https://dev.mysql.com/doc/refman/8.4/en/gone-away.html).

## Sıkça 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.

---

Kaynak: [MySQL Server Has Gone Away Hatası: Nedenleri ve Kalıcı Çözüm](https://cilginyazilim.com/blog/mysql-server-has-gone-away-hatasi)
