MySQL Soket Hataları Giderme Rehberi

MySQL veritabanı sunucusuna bağlanmaya çalışırken karşılaşılan en yaygın ve kafa karıştırıcı sorunlardan biri “Can’t connect to local MySQL server through socket…” hatasıdır. Bu hata, genellikle MySQL istemcisinin sunucuyla iletişim kurmak için kullandığı Unix soket dosyasına erişememesinden kaynaklanır. Bu rehber, MySQL soket hatalarının temel nedenlerini anlamanıza, sorunu adım adım gidermenize ve gelecekte bu tür hataları önlemek için en iyi uygulamaları benimsemenize yardımcı olmayı amaçlamaktadır. Hem yeni başlayanlar hem de deneyimli sistem yöneticileri için pratik bilgiler ve kod örnekleri sunulacaktır.

1. Soket Hatalarının Temel Nedenleri ve Tanımlanması

MySQL’in yerel bir istemci tarafından erişilebilir olması için iki ana bağlantı yöntemi vardır: TCP/IP ve Unix soketleri. Soket bağlantısı, aynı makine üzerinde çalışan bir istemcinin MySQL sunucusuna daha hızlı ve güvenli bir şekilde bağlanmasını sağlayan bir Inter-Process Communication (IPC) mekanizmasıdır. Bu bağlantı türü, bir dosya sistemi yolu üzerinde bulunan özel bir dosya olan Unix soket dosyası aracılığıyla kurulur. Genellikle bu dosya /tmp/mysql.sock, /var/run/mysqld/mysqld.sock veya /run/mysqld/mysqld.sock gibi yollarda bulunur.

Yaygın Hata Mesajları ve Anlamları

Soket hatası aldığınızda, genellikle aşağıdaki gibi bir mesajla karşılaşırsınız:

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)

Veya:

Can't connect to local MySQL server through socket '/tmp/mysql.sock' (111)

Bu hata mesajlarındaki parantez içindeki sayılar (örneğin, (2) veya (111)), sorunun kökeni hakkında önemli ipuçları verir:

(2) - No such file or directory (Dosya veya dizin yok): Bu, en yaygın hata kodlarından biridir. Anlamı, MySQL istemcisinin belirtilen yolda bir soket dosyası bulamadığıdır. Bunun nedenleri şunlar olabilir:
- MySQL sunucusu çalışmıyordur ve dolayısıyla soket dosyasını oluşturmamıştır.
- MySQL sunucusu farklı bir yolda soket dosyası oluşturmuştur ve istemci yanlış yola bakıyordur.
- Soket dosyasının oluşturulacağı dizin mevcut değildir veya MySQL’in bu dizine yazma izni yoktur.
- Soket dosyası bir nedenle silinmiştir.
(111) - Connection refused (Bağlantı reddedildi): Bu hata kodu, soket dosyasının mevcut olduğunu ancak MySQL sunucusunun bağlantıyı reddettiğini gösterir. Bunun nedenleri şunlar olabilir:
- MySQL sunucusu çalışmıyor veya çöküyor olabilir.
- MySQL sunucusu çalışıyor olsa bile, soket dosyası üzerinden gelen bağlantıları kabul etmeyecek şekilde yapılandırılmış olabilir (çok nadir).
- Soket dosyasının veya bulunduğu dizinin izinleri yanlış olabilir, bu da MySQL’in soketi doğru şekilde yönetmesini engelliyordur.

2. İlk Kontroller ve Yaygın Çözümler

Soket hatası almanız durumunda izlemeniz gereken sistematik bir kontrol listesi vardır. Bu adımlar, sorunun çoğunluğunu çözmenize yardımcı olacaktır.

MySQL Sunucusunun Çalışıp Çalışmadığı

En temel adım, MySQL sunucusunun aktif olup olmadığını kontrol etmektir. MySQL çalışmıyorsa, doğal olarak soket dosyası da oluşmayacaktır.

# Linux sistemlerde (systemd kullananlar):
sudo systemctl status mysql
veya
sudo systemctl status mysqld

Linux sistemlerde (SysVinit kullananlar):
sudo service mysql status
veya
sudo service mysqld status

Eğer çıktı “inactive (dead)” veya “stopped” gösteriyorsa, MySQL sunucusunu başlatmanız gerekir:

sudo systemctl start mysql
veya
sudo systemctl start mysqld

Başlatma işlemi başarısız olursa, genellikle hata loglarına bakmanız gerekir (bkz. 3. Bölüm).

Soket Dosyasının Konumu ve Varlığı

MySQL sunucusunun soket dosyasını doğru yerde oluşturduğundan ve istemcinin de o yeri aradığından emin olmalısınız.

Hata mesajındaki yolu kontrol edin: Hata mesajında belirtilen soket yolunu (örn. /var/run/mysqld/mysqld.sock) kontrol edin.
```
ls -l /var/run/mysqld/mysqld.sock
```
Eğer dosya bulunamazsa (“No such file or directory” gibi bir hata alırsanız), soket dosyası ya başka bir yerdedir ya da hiç oluşturulmamıştır.
Soket dosyasını sistemde arayın: MySQL’in soket dosyasını farklı bir dizinde oluşturup oluşturmadığını öğrenmek için sistemde arama yapabilirsiniz.
```
sudo find / -name "mysql.sock" 2>/dev/null
veya daha genel bir arama için:
sudo find / -name "*.sock" 2>/dev/null | grep mysql
```
Bu komutlar, sisteminizdeki tüm .sock uzantılı dosyaları bulmaya çalışacak ve içlerinden “mysql” içerenleri filtreleyecektir. Eğer farklı bir yol bulursanız, bu yolu not alın.

Dosya ve Dizin İzinleri

Soket dosyasının ve onu içeren dizinin izinleri, MySQL sunucusunun ve istemcisinin sokete erişmesi için doğru ayarlanmış olmalıdır. Genellikle soket dosyası mysql kullanıcısı ve grubu tarafından sahip olunur.

# Soket dosyasının izinlerini kontrol edin:
ls -l /var/run/mysqld/mysqld.sock

Soket dosyasının bulunduğu dizinin izinlerini kontrol edin:
ls -ld /var/run/mysqld/

Çıktı genellikle srwxrwxrwx (dosya) ve drwxr-xr-x (dizin) gibi görünür ve kullanıcı/grup mysql olmalıdır. Eğer izinler yanlışsa, MySQL sunucusu soket dosyasını oluşturamayabilir veya istemci erişemeyebilir. İzinleri düzeltmek için:

sudo chown mysql:mysql /var/run/mysqld/mysqld.sock
sudo chmod 777 /var/run/mysqld/mysqld.sock # Genellikle 777 güvenli değildir, ancak test için kullanılabilir.
                                          # Daha güvenli bir yaklaşım, MySQL'in varsayılan olarak ayarladığı izinleri korumaktır.

Dizin izinleri için (eğer dizin yoksa veya izinleri yanlışsa):
sudo mkdir -p /var/run/mysqld/
sudo chown mysql:mysql /var/run/mysqld/
sudo chmod 755 /var/run/mysqld/

Bu değişikliklerden sonra MySQL’i yeniden başlatmayı unutmayın.

MySQL Konfigürasyon Dosyası (my.cnf veya my.ini)

MySQL sunucusu ve istemcisi, hangi soket dosyasını kullanacaklarını my.cnf (Linux) veya my.ini (Windows) dosyasından okur. Bu dosyanın konumu sistemden sisteme değişebilir (örn. /etc/mysql/my.cnf, /etc/my.cnf, /usr/local/mysql/my.cnf).

Konfigürasyon dosyasını düzenleyin ve [mysqld] ile [client] bölümlerindeki socket parametresinin aynı yolu gösterdiğinden emin olun.

# Örnek my.cnf içeriği:
[mysqld]
Diğer ayarlar...
socket=/var/run/mysqld/mysqld.sock

[client]
Diğer ayarlar...
socket=/var/run/mysqld/mysqld.sock

Eğer soket yolu hata mesajındaki yoldan farklıysa, ya my.cnf dosyasını güncelleyerek hata mesajındaki yola eşitleyin ya da MySQL istemcinizi doğru soket yolunu kullanmaya zorlayın:

mysql -u root -p --socket=/path/to/your/mysql.sock

Konfigürasyon dosyasında yaptığınız değişikliklerin geçerli olması için MySQL sunucusunu yeniden başlatmanız gerekir:

sudo systemctl restart mysql

SELinux veya AppArmor

Bazı Linux dağıtımlarında (özellikle CentOS/RHEL ve Ubuntu/Debian), SELinux veya AppArmor gibi güvenlik mekanizmaları MySQL’in soket dosyasına erişmesini veya onu belirli bir dizinde oluşturmasını engelleyebilir.

SELinux:
```
sudo sestatus
```
Eğer SELinux “enforcing” modundaysa, MySQL’in hata loglarında “denied” mesajları arayın. Geçici olarak devre dışı bırakıp test etmek için (sadece sorun giderme amaçlı ve kalıcı değil):
```
sudo setenforce 0
```
Eğer bu sorunu çözüyorsa, kalıcı bir çözüm için SELinux politikalarını güncellemeniz gerekir (genellikle audit2allow aracıyla).
AppArmor:
```
sudo aa-status
```
AppArmor da benzer şekilde MySQL için profil kısıtlamaları uygulayabilir. AppArmor loglarını kontrol edin (örn. /var/log/kern.log veya dmesg çıktısı). AppArmor profilini geçici olarak devre dışı bırakmak için:
```
sudo aa-complain /usr/sbin/mysqld
```
veya tamamen devre dışı bırakmak için:
```
sudo aa-disable /usr/sbin/mysqld
```
Yine, bu geçici bir çözümdür; kalıcı olarak AppArmor profilini düzenlemeniz önerilir.

3. Gelişmiş Sorun Giderme Teknikleri

Yukarıdaki temel kontroller sorunu çözmezse, daha derinlemesine incelemeler yapmanız gerekebilir.

Bağlantı Tipi: TCP/IP vs. Soket

Eğer MySQL sunucunuz çalışıyorsa ve soket dosyasını bulamıyorsanız veya izin sorunları yaşıyorsanız, geçici bir çözüm olarak TCP/IP bağlantısını zorlayabilirsiniz. Bu, özellikle localhost’tan bağlanırken işe yarar.

# TCP/IP üzerinden localhost'a bağlanmak için:
mysql -u root -p -h 127.0.0.1
veya
mysql -u root -p -h localhost --protocol=TCP

Bu komutlar, MySQL istemcisini soket dosyası yerine TCP/IP portu (varsayılan olarak 3306) üzerinden bağlanmaya zorlar. Eğer bu komutlarla bağlanabiliyorsanız, sorun kesinlikle soket dosyasıyla ilgilidir ve MySQL sunucunuzun kendisi çalışıyordur. Bu, sorunu gidermek için size zaman kazandırabilirken, asıl soket sorununu araştırmaya devam etmelisiniz.

MySQL Hata Log Dosyaları

MySQL sunucusunun neden başlamadığını veya soket dosyasını neden oluşturamadığını anlamak için hata loglarına bakmak çok önemlidir. Hata loglarının konumu genellikle my.cnf dosyasında log_error parametresi ile belirtilir, ancak yaygın konumlar şunlardır:

/var/log/mysql/error.log
/var/log/mysqld.log
/var/log/syslog

Log dosyasının sonunu sürekli izlemek için aşağıdaki komutu kullanın:

sudo tail -f /var/log/mysql/error.log
veya
sudo tail -f /var/log/mysqld.log

MySQL’i yeniden başlattıktan sonra bu log dosyasını izleyin. Hata mesajları, disk alanı sorunları, bellek yetersizliği, yapılandırma hataları veya diğer başlangıç sorunları hakkında kritik bilgiler sağlayacaktır.

Sistem Kaynakları

Sistem kaynaklarının yetersizliği de dolaylı olarak soket hatalarına yol açabilir:

Disk Alanı: Soket dosyasının oluşturulacağı dizinde yeterli boş disk alanı yoksa, MySQL soket dosyasını oluşturamaz.
```
df -h /var/run/mysqld/ # veya soket dosyasının bulunduğu dizin
```
Eğer disk alanı doluysa, gereksiz dosyaları temizleyerek yer açmanız gerekebilir.
Bellek (RAM): MySQL sunucusunun başlaması için yeterli RAM yoksa, sunucu başlayamayacak ve dolayısıyla soket dosyası da oluşmayacaktır.
```
free -h
```
Eğer sistem belleği çok düşükse ve MySQL başlamıyorsa, MySQL yapılandırmasındaki bellek ayarlarını (örn. innodb_buffer_pool_size) düşürmeniz veya sisteme daha fazla bellek eklemeniz gerekebilir.

Kalıcı Soket Dosyasını Temizleme

Nadiren de olsa, MySQL sunucusu beklenmedik bir şekilde kapandığında veya çöktüğünde eski bir soket dosyası sistemde kalabilir. Bu dosya, yeni bir MySQL örneğinin başlamasını engelleyebilir veya yanlış bir sokete işaret edebilir. MySQL sunucusunu durdurduktan sonra bu eski soket dosyasını manuel olarak silmek ve ardından sunucuyu tekrar başlatmak sorunu çözebilir.

sudo systemctl stop mysql
sudo rm /var/run/mysqld/mysqld.sock # Hata mesajındaki veya my.cnf'deki yolu kullanın
sudo systemctl start mysql

4. Önleyici Tedbirler ve En İyi Uygulamalar

Soket hatalarını yaşamamak veya en aza indirmek için aşağıdaki önleyici tedbirleri ve en iyi uygulamaları benimseyebilirsiniz:

Tutarlı Konfigürasyon: my.cnf dosyasındaki [mysqld] ve [client] bölümlerinde socket parametresinin her zaman aynı ve erişilebilir bir yolu gösterdiğinden emin olun. Bu, hem sunucunun hem de istemcinin aynı yeri aramasını sağlar.
Düzenli İzleme: MySQL sunucusunun durumunu (systemctl status mysql) ve sistem kaynaklarını (disk alanı, bellek) düzenli olarak izleyin. Otomatik izleme araçları ve uyarı sistemleri kurmak, potansiyel sorunları erken tespit etmenize yardımcı olur.
Yeterli Disk Alanı: Soket dosyalarının bulunduğu dizinlerde ve genel sistemde her zaman yeterli boş disk alanı bulundurun. Log dosyalarının aşırı büyümesi gibi durumlar disk alanını hızla tüketebilir.
Güvenlik Politikaları Yönetimi: SELinux veya AppArmor gibi güvenlik mekanizmaları kullanılıyorsa, MySQL için uygun kuralların tanımlandığından emin olun. Bu politikaları dikkatlice yapılandırın ve herhangi bir değişiklikten sonra MySQL’in beklendiği gibi çalıştığını doğrulayın.
Yazılım Güncellemeleri: MySQL sunucunuzu ve işletim sisteminizi düzenli olarak güncelleyin. Yazılım güncellemeleri, bilinen hataları düzeltebilir ve performans iyileştirmeleri sağlayabilir.
Yedekleme ve Kurtarma Planı: Her zaman güncel bir yedekleme ve kurtarma planınız olsun. Ciddi sistem sorunları durumunda verilerinizi kaybetmemek için bu hayati öneme sahiptir.

Sonuç ve Sıkça Sorulan Sorular (SSS)

MySQL soket hataları, genellikle basit bir yanlış yapılandırma veya sunucu durumundan kaynaklanır. Bu rehberde ele alınan adımları sistematik bir şekilde uygulayarak, çoğu soket hatasını başarıyla giderebilirsiniz. Unutmayın ki sorun gidermenin anahtarı, hata mesajlarını dikkatlice okumak, ilgili log dosyalarını incelemek ve mantıksal bir yaklaşımla olası nedenleri elemekten geçer. Önleyici tedbirler alarak ve sisteminizi düzenli olarak izleyerek, bu tür sorunlarla karşılaşma olasılığınızı önemli ölçüde azaltabilirsiniz.

Sıkça Sorulan Sorular (SSS)

S: MySQL soket dosyası nedir ve neden kullanılır?: C: MySQL soket dosyası, aynı makine üzerinde çalışan bir MySQL istemcisinin, sunucuya TCP/IP bağlantısı yerine daha hızlı ve güvenli bir Inter-Process Communication (IPC) mekanizması üzerinden bağlanmasını sağlayan özel bir dosyadır. Genellikle .sock uzantılıdır ve /tmp veya /var/run/mysqld gibi dizinlerde bulunur.
S: Soket hatası alıyorum ama MySQL çalışıyor gibi görünüyor, ne yapmalıyım?: C: MySQL sunucusu çalışıyor olsa bile, istemcinin aradığı soket yolu yanlış olabilir veya soket dosyasının izinlerinde bir sorun olabilir. my.cnf dosyasındaki [mysqld] ve [client] bölümlerindeki socket yollarının tutarlı olduğundan emin olun. Ayrıca, ls -l komutuyla soket dosyasının izinlerini kontrol edin. Geçici olarak mysql -h 127.0.0.1 -u root -p komutuyla TCP/IP üzerinden bağlanmayı deneyebilirsiniz.
S: my.cnf dosyasını değiştirdikten sonra ne yapmalıyım?: C: my.cnf dosyasında yaptığınız değişikliklerin geçerli olması için MySQL sunucusunu yeniden başlatmanız gerekir. Bunu sudo systemctl restart mysql (systemd tabanlı sistemlerde) veya sudo service mysql restart (SysVinit tabanlı sistemlerde) komutuyla yapabilirsiniz.
S: Uzak bir sunucuya bağlanırken neden soket hatası alıyorum?: C: Uzak bir sunucuya bağlanırken soket hatası almanız beklenmez, çünkü soket bağlantısı yalnızca yerel (aynı makine üzerindeki) bağlantılar için kullanılır. Uzak bağlantılar her zaman TCP/IP üzerinden yapılır. Eğer uzak bir bağlantıda soket hatası alıyorsanız, muhtemelen MySQL istemciniz yanlışlıkla yerel bir bağlantı kurmaya çalışıyor veya bağlantı komutunuzda bir hata var (örn. -h parametresini kullanmayı unutmuşsunuzdur).
S: SELinux veya AppArmor soket hatalarına neden olabilir mi?: C: Evet, kesinlikle. SELinux veya AppArmor gibi güvenlik katmanları, MySQL’in belirli dizinlere yazmasını veya soket dosyasına erişmesini kısıtlayabilir. Bu durumda, MySQL hata loglarında “denied” mesajları görebilirsiniz. Geçici olarak bu güvenlik katmanlarını devre dışı bırakıp test etmek, sorunun kaynağını belirlemenize yardımcı olabilir. Kalıcı çözüm için uygun güvenlik politikalarını yapılandırmanız gerekir.

MySQL Soket Hataları Giderme Rehberi