MySQL / MariaDB bağlantı sorununuz için kontrol listesi

MYSQL / MARIADB · 3306

MySQL / MariaDB bağlantı sorununuz için kontrol listesi

Hata türünü ve istemci ortamını seçin. Size uygun adımları ve komut örneklerini alın; sunucu adı, kullanıcı veya parola girmeniz gerekmez.

Bu bölüm komut çalıştırmaz veya sunucuya bağlanmaz. Komutlardaki örnek adresi ve portu kendi yetkili ortamınıza göre değiştirin. Paylaşılan bağlantıda yalnız seçilen hata, ortam ve istemci bulunur.

Hata türüne göre ilk kontroller

Bağlantı reddedildi / Connection refused

Tam mesaj bağlantı reddi gösteriyorsa bu dalı kullanın. MySQL 2003/10061, MariaDB istemcisi ise 2002 gösterebilir; socket yolu varsa yerel socket dalını seçin.

  1. Kontrolü hatalı uygulamanın çalıştığı makine veya konteyner ağından yapın.
  2. Hedef portta dinleyen servis ile uygulamanın sunucu ve port ayarlarını karşılaştırın.
  3. Açık ret, dinleyici eksikliği veya ağ erişim kuralından kaynaklanabilir; yalnız hata koduyla neden seçmeyin.

Sonraki adım: TCP testi başarılıysa uygulamadaki tam hataya dönün. Başarısızsa sunucu yöneticisiyle dinleyiciyi ve izinli kaynak ağını kontrol edin.

Zaman aşımı / Connection timed out

İstemci bağlantı için bekliyor ve zaman aşımına düşüyorsa bu dalı kullanın.

  1. Uygulamanın kullandığı sunucu adının beklenen IP adresine çözüldüğünü kontrol edin.
  2. VPN, özel ağ ve bulut erişim kurallarını uygulamanın kaynak ağıyla karşılaştırın.
  3. Süreyi artırmadan önce erişim yolunu inceleyin; zaman aşımı tek başına güvenlik duvarını kanıtlamaz.

Sonraki adım: Kendi ağınızdaki sonucu dışarıdan yapılan port testiyle ayrı değerlendirin. Özel veritabanının internete kapalı olması beklenen davranış olabilir.

1045 — Access denied

Veritabanı kimlik doğrulama isteğini reddediyorsa bu dalı kullanın.

  1. İstemcinin doğru ortam ve sunucuya bağlandığını doğrulayın.
  2. Yetkili yöneticiyle kullanıcı-hosta göre hesap eşleşmesini, yetkileri ve kimlik doğrulama yöntemini inceleyin.
  3. Parolayı destek kaydına eklemeyin; başarısız girişleri otomatik olarak tekrarlamayın.

Sonraki adım: Ağ bağlantısı kurulduktan sonraki kimlik doğrulama hatası için rastgele port açmayın. Hesap ayarı düzeltildiğinde asıl uygulama isteğini yeniden kontrol edin.

2002 — Yerel socket bağlantısı

Mesajda socket yolu geçiyorsa TCP testiyle farklı bir bağlantı türünü sınadığınızı unutmayın.

  1. İstemci ve sunucunun aynı makinede olup olmadığını belirleyin.
  2. İstemcinin beklediği socket yolu ile sunucunun kullandığı yolu karşılaştırın.
  3. TCP karşılaştırmasını yalnız yerel sunucunuz TCP dinliyorsa ve hesabınız bu bağlantıya yetkiliyse yapın.

Sonraki adım: Socket dosyasını gelişigüzel silmeyin. TCP ile başarı, socket yolunun veya izinlerinin doğru olduğunu göstermez.

2005 — Unknown server host

Sunucu adı çözümlenemiyorsa önce adlandırma yolunu inceleyin.

  1. Sunucu adında yazım hatası veya yanlış ortam adı olup olmadığını kontrol edin.
  2. Adı uygulamanın çalıştığı ağda çözümleyin; özel DNS veya konteyner servis adı dışarıdan çalışmayabilir.
  3. DNS cevabını beklenen adresle karşılaştırın; DNS başarısı TCP veya oturum açma başarısı değildir.

Sonraki adım: Doğru ağda isim çözümleme çalıştıktan sonra aynı sunucu ve portla bağlantı adımına geçin.

Tüm vakaların kontrol listesini indir

Bu bir teşhis kontrol listesidir; nedenin bulunduğu veya sorunun çözüldüğü anlamına gelmez.

Kaynaklar ve komut belgeleri

2002, 2003 ve 1045: gerçek deneyde ne değişiyor?

9 Kasım 2026’da MySQL 8.4.13 ve MariaDB 11.4.13 istemcilerini kendi sunucularıyla ayrı Linux Docker konteynerlerinde sınadık. Her motor için aynı dört kontrol çalıştı. Dış ağ ve yayımlanan host portu yoktu; testler konteynerin kendi loopback adresini kullandı. İki konteyner ve geçici verileri temizlendi. Bunlar müşteri vakası değil, tekrarlanabilir kontrollü deney sonuçlarıdır.

İki motor, sekiz doğrulanmış sonuç
BağlantıMySQL 8.4.13MariaDB 11.4.13Yorum
TCP 127.0.0.1:33072003 / HY0002002 / HY000Dinleyici yok; bağlantı reddi. Önce adres, port ve dinleyiciyi kontrol edin.
TCP 127.0.0.1:33061045 / 280001045 / 28000Bilerek yanlış parola verildi; sunucuya ulaşıldı ve kimlik doğrulama reddedildi.
SOCKET /tmp/cybertool-absent.sock2002 / HY0002002 / HY000Olmayan Unix soket yolu. TCP portunu değiştirmek bu yolu düzeltmez.
TCP 127.0.0.1:3306SELECT 1 → 1; exit 0SELECT 1 → 1; exit 0Aynı sunucu ve port, doğru geçici parola: başarılı kontrol.

Aynı TCP reddi MySQL istemcisinde 2003, MariaDB istemcisinde 2002 verdi. Olmayan socket ise ikisinde de 2002 verdi. Bu yüzden yalnız hata numarasıyla katmanı belirlemeyin; istemciyi, transport türünü ve tam mesajı okuyun. 1045 bu deneyde yanlış parola nedeniyle üretildi; gerçek sistemde kullanıcı-host eşleşmesi veya kimlik doğrulama yöntemi de sebep olabilir. Sonuçlar bu sürümlere ve Linux ortamına aittir; Windows native istemcisi sınanmadı.

Docker içindeki localhost neden yanıltır?

Uygulama ile veritabanı ayrı konteynerlerdeyse, uygulamadaki 127.0.0.1 uygulama konteynerinin kendisidir. Aynı Docker ağındaki Compose servis adı ve konteyner portunu kullanın; örneğin db:3306. Host üzerinde 3307:3306 eşlemesi olması, diğer konteynerin db:3307 kullanması gerektiği anlamına gelmez. Yukarıdaki deney istemciyi bilerek veritabanı konteynerinin içinde çalıştırır; bu nedenle 127.0.0.1 burada doğrudur. Gerçek uygulama için testi uygulamanın ağından tekrarlayın.

Deneyi kendiniz tekrarlayın

Python 3 ve çalışan Docker gerekir. Paketi çıkarıp aşağıdaki komutları çalıştırın. Her çalıştırma bir geçici konteyner oluşturur; MySQL için 1 GB, MariaDB için 512 MB bellek ve 1 CPU sınırı kullanır. Dört sonucu denetler ve temizler. Betik parolaları çıktıya veya sonuç dosyalarına yazmaz. Çalışırken süreç/konteyner ortamında bulunurlar; Docker erişimi olan yöneticiler bunları görebilir. İlk imaj indirmesi internet gerektirir; deneyin ağı kapalıdır. İmaj etiketleri değişebilir; kullanılan sürüm ve digest paket içindeki iki sonuç JSON dosyasında kayıtlıdır.

docker pull mysql:8.4
python3 mysql_connection_lab.py --engine mysql

docker pull mariadb:11.4
python3 mysql_connection_lab.py --engine mariadb

Deney betiği ve sonuçları içeren paket · GitHub

Kaynaklar: MySQL connection troubleshooting · Docker Compose networking

Aynı uygulama, iki hata: hangi kontrol yapılmalı?

Varsayımsal örnek: Windows uygulaması, yetkili özel ağdaki veritabanına bağlanamıyor. Aşağıdakiler gerçek sunucu çıktısı veya çözülmüş müşteri vakası değildir.

A — 2003 / Connection refused / 10061

TCP bağlantısı reddedilmiş. Uygulamanın çalıştığı ağdan hedef adres ve yapılandırılmış portu kontrol edin; yöneticiyle dinleyen servisi karşılaştırın. Farklı bir bilgisayardan başarılı test, uygulamanın erişimini kanıtlamaz.

Bu örneğin kontrol listesini aç

B — 1045 / Access denied

Sunucu kimlik doğrulamayı reddetmiş. Önce doğru ortama ulaşıldığını, ardından kullanıcı-hosta göre hesap eşleşmesini ve kimlik doğrulama yöntemini yöneticiyle kontrol edin. Bu mesaj tek başına yanlış parola kanıtı değildir.

Bu örneğin kontrol listesini aç

Her örnekten kendi kontrol listenize geçebilirsiniz. Özel veritabanını internete açmak veya güvenlik duvarını kapatmak bu örneklerin çözümü değildir.

Güncel web rehberi · cyber-tool.org